Directories
¶
| Path | Synopsis |
|---|---|
|
Package api is the HTTP layer for Converge.
|
Package api is the HTTP layer for Converge. |
|
Package awsauth wires AWS IAM database authentication (RDS / Aurora) into the Postgres connection paths.
|
Package awsauth wires AWS IAM database authentication (RDS / Aurora) into the Postgres connection paths. |
|
Package broker is the server half of the universal work-distribution API.
|
Package broker is the server half of the universal work-distribution API. |
|
Package conctl implements the converge control-plane CLI — a kubectl-style client for the REST API (apply/get/list/delete over resources, kind manifests, provider configs, reactor bindings, and the cluster registry).
|
Package conctl implements the converge control-plane CLI — a kubectl-style client for the REST API (apply/get/list/delete over resources, kind manifests, provider configs, reactor bindings, and the cluster registry). |
|
apiclient
Package apiclient provides primitives to interact with the openapi HTTP API.
|
Package apiclient provides primitives to interact with the openapi HTTP API. |
|
apiclient/spectool
command
Command spectool down-converts the converge OpenAPI 3.1 golden spec to an equivalent 3.0.3 document that oapi-codegen v2 can consume.
|
Command spectool down-converts the converge OpenAPI 3.1 golden spec to an equivalent 3.0.3 document that oapi-codegen v2 can consume. |
|
Package engine assembles the process from composable DUTIES over one shared Postgres.
|
Package engine assembles the process from composable DUTIES over one shared Postgres. |
|
Package health serves the Kubernetes probe endpoints — /healthz, /livez, and /readyz — for every Converge pod regardless of role.
|
Package health serves the Kubernetes probe endpoints — /healthz, /livez, and /readyz — for every Converge pod regardless of role. |
|
Package kindschema is the server-side schema tooling for kind manifests: it derives a Go type's JSON Schema (authoring), decodes stored schema bytes back into a validator (the round-trip huma can't do on its own output), hashes a manifest's schemas for the stability gate, and lints an in-place re-publish for backward compatibility.
|
Package kindschema is the server-side schema tooling for kind manifests: it derives a Go type's JSON Schema (authoring), decodes stored schema bytes back into a validator (the round-trip huma can't do on its own output), hashes a manifest's schemas for the stability gate, and lints an in-place re-publish for backward compatibility. |
|
meshpbconnect
Package converge.mesh.v1 is the INTERNAL broker↔broker mesh API — NOT part of any worker SDK's contract.
|
Package converge.mesh.v1 is the INTERNAL broker↔broker mesh API — NOT part of any worker SDK's contract. |
|
Package metrics wires OpenTelemetry metrics for the converge control-plane and broker tiers.
|
Package metrics wires OpenTelemetry metrics for the converge control-plane and broker tiers. |
|
Package model holds the kind-agnostic CORE contract: the kind-identity primitives (Kind, KindVersion, ResourceRef, ResourceManifest), the reaction request/response and composition value types the control plane builds from a DB row and applies (Resource, ReactionRequest, Outcome, ChildSpec, DepEdge, …), the author-facing Trigger/Transition enums, the config-merge helpers, the per-stage wire DTOs, the CRD-style KindManifest with its validation lattice, and the StageDispatcher seam.
|
Package model holds the kind-agnostic CORE contract: the kind-identity primitives (Kind, KindVersion, ResourceRef, ResourceManifest), the reaction request/response and composition value types the control plane builds from a DB row and applies (Resource, ReactionRequest, Outcome, ChildSpec, DepEdge, …), the author-facing Trigger/Transition enums, the config-merge helpers, the per-stage wire DTOs, the CRD-style KindManifest with its validation lattice, and the StageDispatcher seam. |
|
providers
|
|
|
stdcel
Package stdcel is the GENERIC, kro-style composer: it turns a RESOURCE GRAPH DEFINITION expressed entirely as DATA — a set of child resources whose fields are CEL expressions over the instance's spec and over each other — into a child DAG, with no per-kind Go.
|
Package stdcel is the GENERIC, kro-style composer: it turns a RESOURCE GRAPH DEFINITION expressed entirely as DATA — a set of child resources whose fields are CEL expressions over the instance's spec and over each other — into a child DAG, with no per-kind Go. |
|
stdio
Package stdio is the GENERIC provider: it lets an external program — written in ANY language, with no converge Go SDK — act as a converge resource kind via a stdin/stdout JSON protocol.
|
Package stdio is the GENERIC provider: it lets an external program — written in ANY language, with no converge Go SDK — act as a converge resource kind via a stdin/stdout JSON protocol. |
|
stdshell
Package stdshell is a REAL leaf provider that runs a user-supplied script.
|
Package stdshell is a REAL leaf provider that runs a user-supplied script. |
|
stdstarlark
Package stdstarlark is the GENERIC Starlark composer: it runs an operator-supplied Starlark program — shipped as a zip of .star files in the providerconfig BUNDLE — that fans a resource's spec out into a child DAG (children + edges + provider configs), with no per-kind Go.
|
Package stdstarlark is the GENERIC Starlark composer: it runs an operator-supplied Starlark program — shipped as a zip of .star files in the providerconfig BUNDLE — that fans a resource's spec out into a child DAG (children + edges + provider configs), with no per-kind Go. |
|
stdterraform
Package stdterraform is a REAL leaf provider that runs a user's Terraform module as a converge resource: its spec points at a module (a *.tar.gz in S3, GCS, Azure Blob, or over HTTPS, or a git repo), and per task the worker fetches it, injects a state backend keyed to the resource, and runs a real `terraform apply` (or `terraform destroy` on delete).
|
Package stdterraform is a REAL leaf provider that runs a user's Terraform module as a converge resource: its spec points at a module (a *.tar.gz in S3, GCS, Azure Blob, or over HTTPS, or a git repo), and per task the worker fetches it, injects a state backend keyed to the resource, and runs a real `terraform apply` (or `terraform destroy` on delete). |
|
Package runtime is the per-pod runtime that drives providers.
|
Package runtime is the per-pod runtime that drives providers. |
|
Package shardutil holds the shard-space size constant and tiny helpers for assigning pod-to-shard ownership.
|
Package shardutil holds the shard-space size constant and tiny helpers for assigning pod-to-shard ownership. |
|
Package specschema is the SINGLE server-side schema validator for resource specs, providerconfig documents, and operate-verb inputs.
|
Package specschema is the SINGLE server-side schema validator for resource specs, providerconfig documents, and operate-verb inputs. |
|
Package store wraps the sqlc-generated dbq package with the higher-level operations the rest of the codebase uses: sorted+typed bulk upserts, provider-friendly task abstractions, polymorphic outbox append, soft-delete primitives.
|
Package store wraps the sqlc-generated dbq package with the higher-level operations the rest of the codebase uses: sorted+typed bulk upserts, provider-friendly task abstractions, polymorphic outbox append, soft-delete primitives. |
|
Package wire is the CORE-SIDE converter between the internal/model stage request/response types and their typed proto wire forms (sdk-go/workerpb — the public worker contract).
|
Package wire is the CORE-SIDE converter between the internal/model stage request/response types and their typed proto wire forms (sdk-go/workerpb — the public worker contract). |
Click to show internal directories.
Click to hide internal directories.