Files
41536738c8 refactor(cd): hard-fork - rename CRD API group argoproj.io -> deploy.hanzo.ai (#1)
* feat(api): hard-fork CRD API group argoproj.io -> deploy.hanzo.ai

Hanzo CD hard-fork, phase 1.1. Single source of truth is
pkg/apis/application/register.go's Group constant (Application/AppProject/
ApplicationSet all derive their FullName from it); every other Go call-site
that hardcoded the literal group string is updated to match: the 3 generated
informer GVRs, the app-of-apps nested-Application detector in types.go, the
resource-tree Application-kind cache populator, the 3 NotFound error
constructors in server/application, and the applicationset-controller's
leader-election Lease name/ID (kept in lockstep across Go source + RBAC
resourceNames, or leader election would get RBAC-denied on startup).

CRD YAMLs (application/appproject/applicationset) and every RBAC apiGroups
rule that actually governs our 3 CRDs are repointed to deploy.hanzo.ai, across
both manifests/base/* (namespaced Roles) and manifests/cluster-rbac/* (cluster
scope). Two adjacent things that share the "argoproj.io" string but are NOT
ours are deliberately left untouched: gitops-engine's health-check dispatch
for Argo Workflows' `Workflow` kind, and argocd-server-clusterrole's second
apiGroups block granting read on Argo Workflows' `workflows` resource — both
belong to a separate, unrelated Argoproj-family project we are not forking.

Also untouched, per explicit scope: annotation/label keys (argocd.argoproj.io/*)
and finalizers (*.argoproj.io) that track already-applied live resources, and
argocd-cm.yaml's resource.customizations.ignoreResourceUpdates keys (a narrow
app-of-apps diffing nicety, not build- or RBAC-relevant).

CGO_ENABLED=0 go build ./... verified green.

* ci: wire canonical hanzo.yml + cicd.yml (Hanzo CD image build)

Phase 1.3. Follows the same one-way pattern every hanzo/lux/zoo repo uses:
hanzo.yml declares the image (root Dockerfile -> ghcr.io/hanzoai/deploy) and a
fast go-build sanity test (the multi-stage Dockerfile build is the slow, real
gate); cicd.yml is the ~10-line trigger shim importing hanzoai/ci's reusable
build workflow on the arc pool, secrets from KMS only.

No `deploy:` block yet, matching the hanzoai/cms build-only-first-cutover
pattern: this repo's own live hanzo-cd namespace runs the whole Hanzo fleet's
GitOps, so the prod image/CRD swap is a deliberate separate action (see the
[HELD] universe PR), never an automatic rollout on merge. Every PR/push still
builds and pushes an immutable ghcr.io/hanzoai/deploy:sha-<7>-amd64 image.

* feat(ui): rebrand Argo CD -> Hanzo CD (title, favicon, logo, sidebar)

Phase 1.2. User-facing "Argo CD"/"ArgoCD" text replaced with "Hanzo CD"
across the login page, help modal, settings screens, version-info panel,
sync-options warning, fullscreen-logs title, app.tsx page titles, and
index.html's <title>/noscript text (dropped the now-wrong upstream CLI
doc link rather than invent a hanzo.ai URL that doesn't exist).

Logo/favicon assets replaced with the canonical Hanzo mark (never
hand-drawn, copied from ~/work/hanzo/logo/dist): the two real usages of
Argo's logo collapse onto one Hanzo glyph (mono + white variants) at the
same 5 call sites (login icon + footer, login.scss $logoPath/
$logoNegativePath, sidebar text-logo), preserving the existing CSS
invert() filters so both the light login panel and dark sidebar still
render correctly. Old argologo.svg/argo_o.svg/argo.png deleted (no
longer referenced). favicon-{16x16,32x32}.png added at
ui/src/assets/favicon/ (index.html's links to that path were previously
dead - the directory didn't exist in this checkout). package.json name
argo-cd-ui -> hanzo-cd-ui.

Left alone, deliberately: the two Kubernetes resource-kind icon sets
under ui/src/assets/images/resources/ (unrelated to branding), and
upstream doc/project links (argoproj.io, argo-cd.readthedocs.io) since
we have no equivalent hanzo.ai docs to point to yet - except the login
footer logo's outbound link, which now points to hanzo.ai instead of
argoproj.io (a Hanzo-branded mark linking to the upstream project it
was forked from read as an obvious leftover).

* feat(module): rename Go module github.com/argoproj/argo-cd/v3 -> github.com/hanzoai/deploy

Phase 2. No version suffix on the new path (org policy: never publish our
own Go modules above v1.x.x / with a v2+ suffix) — this fork starts a fresh
v0/v1 module identity rather than carrying the v3 the upstream fork point
had reached.

Mechanical, symmetric rewrite: 704 .go files (import statements only; two
disjoint substitutions applied specific-first so the nested gitops-engine
module path never double-matches), plus go.mod (module line, the
gitops-engine require+replace pair, version reset to v0.0.0-... since a
suffix-less path can't carry a v3 semver), gitops-engine/go.mod, Makefile
(ldflags PACKAGE + 2 TEST_MODULE filters), .golangci.yaml, .goreleaser.yaml,
.mockery.yaml (+ gitops-engine's), Procfile, the codegen/proto generation
scripts (hack/generate-proto.sh, update-codegen.sh, update-openapi.sh), and
20 .proto files' go_package options. Also one OpenTelemetry tracer name
string in gitops-engine/pkg/sync/sync_context.go (a cosmestic label, not an
import, but worth keeping consistent).

CGO_ENABLED=0 go build ./... verified green for both the root module and
the nested gitops-engine module; go vet clean on both; go mod tidy run
(network available) to reconcile go.sum, dependency set unchanged.

Left alone, deliberately: doc-only mentions (docs/snyk/*.html scan reports,
gitops-engine/README.md), a comment-only reference in
.github/workflows/release.yaml, and one Renovate bot config line — none are
build- or codegen-load-bearing. Also left alone: comments citing upstream
GitHub issue URLs (github.com/argoproj/argo-cd/issues/NNNNN) and a handful
of test fixtures using "https://github.com/argoproj/argo-cd.git" as a
representative example repo URL — both are accurate historical/test-data
references, not stale self-references.

---------

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-29 18:27:58 -07:00

380 lines
15 KiB
Protocol Buffer

syntax = "proto3";
option go_package = "github.com/hanzoai/deploy/reposerver/apiclient";
package repository;
import "github.com/hanzoai/deploy/pkg/apis/application/v1alpha1/generated.proto";
import "google/protobuf/empty.proto";
// ManifestRequest is a query for manifest generation.
message ManifestRequest {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
// revision, potentially un-resolved
string revision = 2;
bool noCache = 3;
string appLabelKey = 4;
// Name of the application for which the request is triggered
string appName = 5;
string namespace = 8;
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.ApplicationSource applicationSource = 10;
repeated github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repos = 11;
// Deprecated: use sidecar plugins instead.
repeated github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.ConfigManagementPlugin plugins = 12;
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.KustomizeOptions kustomizeOptions = 13;
// KubeVersion is the Kubernetes API version from the destination cluster.
string kubeVersion = 14;
// ApiVersions is the list of API versions from the destination cluster, used for rendering Helm charts.
repeated string apiVersions = 15;
// Deprecated: Use sourceIntegrity for more detailed information. verifySignature will be removed with the next major version.
bool verifySignature = 16; // TODO: Remove deprecated https://github.com/argoproj/argo-cd/issues/27695
repeated github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.RepoCreds helmRepoCreds = 17;
bool noRevisionCache = 18;
string trackingMethod = 19;
map<string, bool> enabledSourceTypes = 20;
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.HelmOptions helmOptions = 21;
bool hasMultipleSources = 22;
map<string, github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.RefTarget> refSources = 23;
// This is used to surface "source not permitted" errors for Helm repositories
repeated string projectSourceRepos = 24;
// This is used to surface "source not permitted" errors for Helm repositories
string projectName = 25;
// argocd.argoproj.io/manifest-generate-paths annotation value of the Application to allow optimize which resources propagated to cmpserver
string annotationManifestGeneratePaths = 26;
// Holds instance installation id
string installationID = 27;
// Source integrity constrains to verify the sources before use
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.SourceIntegrity sourceIntegrity = 28;
}
message ManifestRequestWithFiles {
oneof part {
ManifestRequest request = 1;
ManifestFileMetadata metadata = 2;
ManifestFileChunk chunk = 3;
}
}
message ManifestFileMetadata {
// checksum is used to verify the integrity of the file
string checksum = 1;
// size relates to the file size in bytes
int64 size = 2;
}
message ManifestFileChunk {
bytes chunk = 1;
}
// TestRepositoryRequest is a query to test repository is valid or not and has valid access.
message TestRepositoryRequest {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
}
// TestRepositoryResponse represents the TestRepository response
message TestRepositoryResponse {
// Request to verify the signature when generating the manifests (only for Git repositories)
bool verifiedRepository = 1;
}
// ResolveRevisionRequest
message ResolveRevisionRequest {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Application app = 2;
string ambiguousRevision = 3;
int64 sourceIndex = 4;
bool noRevisionCache = 5;
}
// ResolveRevisionResponse
message ResolveRevisionResponse {
// returns the resolved revision
string revision = 1;
string ambiguousRevision = 2;
}
message ManifestResponse {
repeated string manifests = 1;
string namespace = 2;
string server = 3;
// resolved revision
string revision = 4;
string sourceType = 6;
// Deprecated: Use sourceIntegrityResult for more detailed information. verifyResult will be removed with the next major version.
string verifyResult = 7;
// Commands is the list of commands used to hydrate the manifests
repeated string commands = 8;
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.SourceIntegrityCheckResult sourceIntegrityResult = 9;
}
message ListRefsRequest {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
}
// A subset of the repository's named refs
message Refs {
repeated string branches = 1;
repeated string tags = 2;
}
// ListAppsRequest requests a repository directory structure
message ListAppsRequest {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
string revision = 2;
map<string, bool> enabledSourceTypes = 3;
}
// AppList returns the contents of the repo of a ListApps request
message AppList {
map<string, string> apps = 1;
}
message PluginInfo {
string name = 1;
}
// PluginList returns the list of all cmp v2 plugins running as sidecars
message PluginList {
repeated PluginInfo items = 1;
}
// RepoServerAppDetailsQuery contains query information for app details request
message RepoServerAppDetailsQuery {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.ApplicationSource source = 2;
repeated github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repos = 3;
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.KustomizeOptions kustomizeOptions = 4;
string appName = 5;
bool noCache = 6;
bool noRevisionCache = 7;
string trackingMethod = 8;
map<string, bool> enabledSourceTypes = 9;
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.HelmOptions helmOptions = 10;
map<string, github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.RefTarget> refSources = 11;
}
// RepoAppDetailsResponse application details
message RepoAppDetailsResponse {
string type = 1;
HelmAppSpec helm = 3;
KustomizeAppSpec kustomize = 4;
DirectoryAppSpec directory = 5;
PluginAppSpec plugin = 6;
}
message RepoServerRevisionMetadataRequest {
// the repo
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
// the revision within the repo
string revision = 2;
// Deprecated: Use sourceIntegrity for more detailed information. checkSignature will be removed with the next major version.
bool checkSignature = 3; // TODO: Remove deprecated https://github.com/argoproj/argo-cd/issues/27695
// Source integrity constrains to verify the sources before use
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.SourceIntegrity sourceIntegrity = 4;
}
message RepoServerRevisionChartDetailsRequest {
// the repo
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
// the chart
string name = 2;
// the revision within the chart
string revision = 3;
}
// HelmAppSpec contains helm app name in source repo
message HelmAppSpec {
string name = 1;
repeated string valueFiles = 3;
// the output of `helm inspect values`
repeated github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.HelmParameter parameters = 4;
// the contents of values.yaml
string values = 5;
// helm file parameters
repeated github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.HelmFileParameter fileParameters = 6;
}
// KustomizeAppSpec contains kustomize images
message KustomizeAppSpec {
// images is a list of available images.
repeated string images = 3;
}
// DirectoryAppSpec contains directory
message DirectoryAppSpec {
}
message ParameterAnnouncement {
// name is the name identifying a parameter.
string name = 1;
// title is a human-readable text of the parameter name.
string title = 2;
// tooltip is a human-readable description of the parameter.
string tooltip = 3;
// required defines if this given parameter is mandatory.
bool required = 4;
// itemType determines the primitive data type represented by the parameter. Parameters are always encoded as
// strings, but this field lets them be interpreted as other primitive types.
string itemType = 5;
// collectionType is the type of value this parameter holds - either a single value (a string) or a collection
// (array or map). If collectionType is set, only the field with that type will be used. If collectionType is not
// set, `string` is the default. If collectionType is set to an invalid value, a validation error is thrown.
string collectionType = 6;
// string is the default value of the parameter if the parameter is a string.
string string = 7;
// array is the default value of the parameter if the parameter is an array.
repeated string array = 8;
// map is the default value of the parameter if the parameter is a map.
map<string, string> map = 9;
}
// PluginAppSpec contains details about a plugin-type Application
message PluginAppSpec {
repeated ParameterAnnouncement parametersAnnouncement = 1;
}
message HelmChartsRequest {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
}
message HelmChart {
string name = 1;
repeated string versions = 2;
}
message HelmChartsResponse {
repeated HelmChart items = 1;
}
message GitFilesRequest {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
bool submoduleEnabled = 2;
string revision = 3;
string path = 4;
bool NewGitFileGlobbingEnabled = 5;
bool noRevisionCache = 6;
// Deprecated: Use sourceIntegrity for more detailed information. verifyCommit will be removed with the next major version.
bool verifyCommit = 7; // TODO: Remove deprecated https://github.com/argoproj/argo-cd/issues/27695
// Source integrity constrains to verify the sources before use
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.SourceIntegrity sourceIntegrity = 8;
}
message GitFilesResponse {
// Map consisting of path of the path to its contents in bytes
map<string, bytes> map = 1;
}
message GitDirectoriesRequest {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
bool submoduleEnabled = 2;
string revision = 3;
bool noRevisionCache = 4;
// Deprecated: Use sourceIntegrity for more detailed information. verifyCommit will be removed with the next major version.
bool verifyCommit = 5; // TODO: Remove deprecated https://github.com/argoproj/argo-cd/issues/27695
// Source integrity constrains to verify the sources before use
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.SourceIntegrity sourceIntegrity = 6;
}
message GitDirectoriesResponse {
// A set of directory paths
repeated string paths = 1;
}
message UpdateRevisionForPathsRequest {
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.Repository repo = 1;
string appLabelKey = 2;
string appName = 3;
string namespace = 4;
github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.ApplicationSource applicationSource = 5;
string trackingMethod = 6;
map<string, github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.RefTarget> refSources = 7;
string kubeVersion = 8;
repeated string apiVersions = 9;
bool hasMultipleSources = 10;
string syncedRevision = 11;
string revision = 12;
repeated string paths = 13;
bool noRevisionCache = 14;
string installationID = 15;
map<string, github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.RefTarget> syncedRefSources = 16;
}
message UpdateRevisionForPathsResponse {
// Changes indicates whether any changes were detected in the provided paths. If false, it means that the manifest
// cache was updated to the new revision. If true, it means that there are relevant changes in the repo files and
// that new manifests should be generated.
bool changes = 1;
string revision = 2;
}
// ManifestService
service RepoServerService {
// GenerateManifest generates manifest for application in specified repo name and revision
rpc GenerateManifest(ManifestRequest) returns (ManifestResponse) {
}
// GenerateManifestWithFiles generates manifest for application using provided tarball of files
rpc GenerateManifestWithFiles(stream ManifestRequestWithFiles) returns (ManifestResponse) {
}
// Returns a bool val if the repository is valid and has proper access
rpc TestRepository(TestRepositoryRequest) returns (TestRepositoryResponse) {
}
// Returns a valid revision
rpc ResolveRevision(ResolveRevisionRequest) returns (ResolveRevisionResponse) {
}
// Returns a list of refs (e.g. branches and tags) in the repo
rpc ListRefs(ListRefsRequest) returns (Refs) {
}
// Returns a list of oci tags in the repo
rpc ListOCITags(ListRefsRequest) returns (Refs) {
}
// ListApps returns a list of apps in the repo
rpc ListApps(ListAppsRequest) returns (AppList) {
}
// ListPlugins returns a list of cmp v2 plugins running as sidecar to reposerver
rpc ListPlugins(google.protobuf.Empty) returns (PluginList) {
}
// Generate manifest for application in specified repo name and revision
rpc GetAppDetails(RepoServerAppDetailsQuery) returns (RepoAppDetailsResponse) {
}
// Get the meta-data (author, date, tags, message) for a specific revision of the repo
rpc GetRevisionMetadata(RepoServerRevisionMetadataRequest) returns (github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.RevisionMetadata) {
}
// Get the meta-data (author, date, tags, message) for a specific revision of the OCI image
rpc GetOCIMetadata(RepoServerRevisionChartDetailsRequest) returns (github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.OCIMetadata) {
}
// Get the chart details (author, date, tags, message) for a specific revision of the repo
rpc GetRevisionChartDetails(RepoServerRevisionChartDetailsRequest) returns (github.com.argoproj.argo_cd.v3.pkg.apis.application.v1alpha1.ChartDetails) {
}
// GetHelmCharts returns list of helm charts in the specified repository
rpc GetHelmCharts(HelmChartsRequest) returns (HelmChartsResponse) {
}
// GetGitFiles returns a set of file paths and their contents for the given repo
rpc GetGitFiles(GitFilesRequest) returns (GitFilesResponse) {
}
// GetGitDirectories returns a set of directory paths for the given repo
rpc GetGitDirectories(GitDirectoriesRequest) returns (GitDirectoriesResponse) {
}
// UpdateRevisionForPaths will compare two revisions and update the cache with the new revision if no changes are detected in the provided paths
rpc UpdateRevisionForPaths(UpdateRevisionForPathsRequest) returns (UpdateRevisionForPathsResponse) {
}
}