pkg/

directory
v1.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: Apache-2.0

Directories

Path Synopsis
Package allocpolicy is the canonical, dependency-neutral owner of the #1327 GPU allocation-policy descriptor and the shared advertiser vocabulary and tuple-coherence rules (ADR-015, "GKE amendment to the #1327 allocation-policy model").
Package allocpolicy is the canonical, dependency-neutral owner of the #1327 GPU allocation-policy descriptor and the shared advertiser vocabulary and tuple-coherence rules (ADR-015, "GKE amendment to the #1327 allocation-policy model").
Package artifact defines the neutral release inventory and catalog bindings.
Package artifact defines the neutral release inventory and catalog bindings.
Package bom builds CycloneDX 1.6 software bills-of-materials describing the container images AICR can deploy.
Package bom builds CycloneDX 1.6 software bills-of-materials describing the container images AICR can deploy.
Package bundler provides orchestration for generating deployment bundles from recipes.
Package bundler provides orchestration for generating deployment bundles from recipes.
attestation
Package attestation provides bundle attestation using Sigstore signing.
Package attestation provides bundle attestation using Sigstore signing.
bundleinfo
Package bundleinfo defines bundle-info.yaml, the bundle-root build record written at the root of every generated deployment bundle.
Package bundleinfo defines bundle-info.yaml, the bundle-root build record written at the root of every generated deployment bundle.
checksum
Package checksum provides closed-world SHA256 bundle inventories.
Package checksum provides closed-world SHA256 bundle inventories.
config
Package config provides configuration options for bundler implementations.
Package config provides configuration options for bundler implementations.
deployer
Package deployer defines the shared interface and types for bundle deployers.
Package deployer defines the shared interface and types for bundle deployers.
deployer/argocd
Package argocd provides Argo CD Application generation for recipes.
Package argocd provides Argo CD Application generation for recipes.
deployer/argocd/argocdtest
Package argocdtest provides child Application name fixtures shared by the argocd and argocd-helm deployer tests.
Package argocdtest provides child Application name fixtures shared by the argocd and argocd-helm deployer tests.
deployer/argocdhelm
Package argocdhelm generates a Helm chart app-of-apps for Argo CD with dynamic install-time values.
Package argocdhelm generates a Helm chart app-of-apps for Argo CD with dynamic install-time values.
deployer/deployertest
Package deployertest provides recipe fixtures shared by the deployer tests.
Package deployertest provides recipe fixtures shared by the deployer tests.
deployer/fleet
Package fleet generates a Rancher Fleet bundle from AICR recipes, as a GitRepo (ModeGitRepo, the default) or as HelmOps (ModeHelmOp).
Package fleet generates a Rancher Fleet bundle from AICR recipes, as a GitRepo (ModeGitRepo, the default) or as HelmOps (ModeHelmOp).
deployer/flux
Package flux provides Flux manifest generation for AICR recipes.
Package flux provides Flux manifest generation for AICR recipes.
deployer/helm
Package helm generates per-component Helm bundles from recipe results.
Package helm generates per-component Helm bundles from recipe results.
deployer/helmfile
Package helmfile generates a helmfile.yaml release graph from a configured recipe.
Package helmfile generates a helmfile.yaml release graph from a configured recipe.
deployer/localformat
Package localformat writes the uniform numbered local-chart bundle layout.
Package localformat writes the uniform numbered local-chart bundle layout.
deployer/localformat/localformattest
Package localformattest provides a localformat.ChartPuller for tests.
Package localformattest provides a localformat.ChartPuller for tests.
deployer/terraform
Package terraform generates a Terraform module from an AICR recipe: a root module by default, or a child module to call from a configuration that owns the helm provider.
Package terraform generates a Terraform module from an AICR recipe: a root module by default, or a child module to call from a configuration that owns the helm provider.
drainscope
Package drainscope owns what NVSentinel's node-drainer may evict and how long it waits: the namespaces a drain never evicts from, and the default drain mode.
Package drainscope owns what NVSentinel's node-drainer may evict and how long it waits: the namespaces a drain never evicts from, and the default drain mode.
gatemanifest
Package gatemanifest synthesizes the Kubernetes manifests for a component readiness gate Job (ServiceAccount, RBAC, ConfigMap, Job).
Package gatemanifest synthesizes the Kubernetes manifests for a component readiness gate Job (ServiceAccount, RBAC, ConfigMap, Job).
registry
Package registry provides thread-safe registration and retrieval of bundler implementations.
Package registry provides thread-safe registration and retrieval of bundler implementations.
result
Package result provides types for tracking bundle generation results.
Package result provides types for tracking bundle generation results.
types
Package types defines the type system for bundler implementations.
Package types defines the type system for bundler implementations.
verifier
Package verifier implements offline bundle verification with a four-level trust model.
Package verifier implements offline bundle verification with a four-level trust model.
Package chainsaw executes Chainsaw-style assertions against a live Kubernetes cluster, in-process.
Package chainsaw executes Chainsaw-style assertions against a live Kubernetes cluster, in-process.
validation
Package validation checks Chainsaw YAML without executing assertions.
Package validation checks Chainsaw YAML without executing assertions.
chainsawgate
runner
Package runner contains the chainsaw-test evaluation machinery used by the standalone `gate` CLI.
Package runner contains the chainsaw-test evaluation machinery used by the standalone `gate` CLI.
Package cli implements the command-line interface for the AICR aicr tool.
Package cli implements the command-line interface for the AICR aicr tool.
client
v1
Package aicr is the public, compatibility-reviewed Go library surface for external consumers of the AI Cluster Runtime.
Package aicr is the public, compatibility-reviewed Go library surface for external consumers of the AI Cluster Runtime.
Package collector provides interfaces and implementations for collecting system configuration data.
Package collector provides interfaces and implementations for collecting system configuration data.
file
Package file provides a configurable parser for line-oriented configuration files (e.g., /etc/default/grub, /etc/os-release, /proc/sys entries).
Package file provides a configurable parser for line-oriented configuration files (e.g., /etc/default/grub, /etc/os-release, /proc/sys entries).
gpu
Package gpu collects GPU hardware data via driver-free NFD/PCI enumeration.
Package gpu collects GPU hardware data via driver-free NFD/PCI enumeration.
k8s
Package k8s collects Kubernetes cluster configuration data.
Package k8s collects Kubernetes cluster configuration data.
network
Package network collects per-hardware-group network topology by ingesting k8s-launch-kit (l8k) cluster-config data and translating it into the NetworkTopology Measurement shape documented in docs/integrator/measurement-api.md.
Package network collects per-hardware-group network topology by ingesting k8s-launch-kit (l8k) cluster-config data and translating it into the NetworkTopology Measurement shape documented in docs/integrator/measurement-api.md.
os
Package os collects operating system configuration data.
Package os collects operating system configuration data.
systemd
Package systemd collects systemd service configuration data.
Package systemd collects systemd service configuration data.
talos
Package talos provides Talos-specific collector implementations used in place of the systemd D-Bus and /proc-based OS collectors when the recipe criteria declares os: talos.
Package talos provides Talos-specific collector implementations used in place of the systemd D-Bus and /proc-based OS collectors when the recipe criteria declares os: talos.
Package component provides shared bundler utilities used by pkg/bundler and its deployers.
Package component provides shared bundler utilities used by pkg/bundler and its deployers.
Package config defines the AICRConfig file schema accepted by the aicr CLI's --config flag on the snapshot, recipe, bundle, validate, and verify commands.
Package config defines the AICRConfig file schema accepted by the aicr CLI's --config flag on the snapshot, recipe, bundle, validate, and verify commands.
Package constraints parses and evaluates constraint expressions (e.g.
Package constraints parses and evaluates constraint expressions (e.g.
expr
Package expr parses constraint expressions ("<operator> <value>") and evaluates them against a single actual value.
Package expr parses constraint expressions ("<operator> <value>") and evaluates them against a single actual value.
Package corroborate computes the recipe corroboration consensus model and emits the deterministic interim-evidence dashboard (GP4, #1404; user guide docs/user/evidence-dashboard.md).
Package corroborate computes the recipe corroboration consensus model and emits the deterministic interim-evidence dashboard (GP4, #1404; user guide docs/user/evidence-dashboard.md).
Package defaults provides centralized configuration constants for the AICR system.
Package defaults provides centralized configuration constants for the AICR system.
Package deprecation implements the runtime half of the AICR deprecation channel.
Package deprecation implements the runtime half of the AICR deprecation channel.
Package diff compares AICR snapshots to detect configuration drift.
Package diff compares AICR snapshots to detect configuration drift.
Package errors provides structured error types for better observability and programmatic error handling across the application.
Package errors provides structured error types for better observability and programmatic error handling across the application.
errorstest
Package errorstest provides test assertions on the error code a pkg/errors chain reports.
Package errorstest provides test assertions on the error code a pkg/errors chain reports.
Package evidence is an umbrella for AICR's evidence kinds.
Package evidence is an umbrella for AICR's evidence kinds.
allowlist
Package allowlist loads and validates the maintained signer allowlist at recipes/evidence/allowlist.yaml.
Package allowlist loads and validates the maintained signer allowlist at recipes/evidence/allowlist.yaml.
attestation
Package attestation implements the recipe-test-attestation evidence kind defined in ADR-007 (docs/design/007-recipe-evidence.md).
Package attestation implements the recipe-test-attestation evidence kind defined in ADR-007 (docs/design/007-recipe-evidence.md).
canonical
Package canonical holds the recipe YAML canonicalization and subject digest that recipe evidence is built and verified against.
Package canonical holds the recipe YAML canonicalization and subject digest that recipe evidence is built and verified against.
cncf
Package cncf renders CNCF AI Conformance evidence markdown from CTRF reports against a published upstream checklist version.
Package cncf renders CNCF AI Conformance evidence markdown from CTRF reports against a published upstream checklist version.
cncf/upstreamvalidator
Package upstreamvalidator runs the CNCF AI Conformance submission validator, cncf/k8s-ai-conformance scripts/validate.go, in process at a pinned revision.
Package upstreamvalidator runs the CNCF AI Conformance submission validator, cncf/k8s-ai-conformance scripts/validate.go, in process at a pinned revision.
index
Package index is the build-time inventory of committed recipe-evidence pointers.
Package index is the build-time inventory of committed recipe-evidence pointers.
internal/boundedio
Package boundedio puts blocking local-filesystem work behind a cancellation boundary so the evidence publish/sign/verify paths cannot hang indefinitely on a dead NFS/FUSE mount.
Package boundedio puts blocking local-filesystem work behind a cancellation boundary so the evidence publish/sign/verify paths cannot hang indefinitely on a dead NFS/FUSE mount.
project
Package project synthesizes the source-keyed evidence tree that the GP4 corroborate consensus generator consumes.
Package project synthesizes the source-keyed evidence tree that the GP4 corroborate consensus generator consumes.
redact
Package redact minimizes the sensitive operational detail an evidence bundle physically ships, while leaving the cryptographic verification story intact.
Package redact minimizes the sensitive operational detail an evidence bundle physically ships, while leaving the cryptographic verification story intact.
verifier
Package verifier implements `aicr evidence verify`: offline verification of a recipe-evidence bundle (v1 or v2) produced by `aicr validate --emit-attestation`.
Package verifier implements `aicr evidence verify`: offline verification of a recipe-evidence bundle (v1 or v2) produced by `aicr validate --emit-attestation`.
Package fingerprint extracts a structured cluster identity from a snapshot's collector measurements and compares it against a recipe's criteria.
Package fingerprint extracts a structured cluster identity from a snapshot's collector measurements and compares it against a recipe's criteria.
Package header provides common header types for AICR data structures.
Package header provides common header types for AICR data structures.
Package health computes per-recipe structural health across the whole criteria matrix, as specified by ADR-009 (Recipe Health Tracking).
Package health computes per-recipe structural health across the whole criteria matrix, as specified by ADR-009 (Recipe Health Tracking).
Package helm runs the helm CLI and renders charts with helm template.
Package helm runs the helm CLI and renders charts with helm template.
helmtest
Package helmtest provides test helpers for consumers of pkg/helm.
Package helmtest provides test helpers for consumers of pkg/helm.
Package inventory reads the installed component inventory from a live cluster and returns it as the component-to-version table an upgrade comparison consumes.
Package inventory reads the installed component inventory from a live cluster and returns it as the component-to-version table an upgrade comparison consumes.
k8s
Package k8s provides Kubernetes integration for AI Cluster Runtime.
Package k8s provides Kubernetes integration for AI Cluster Runtime.
agent
Package agent provides Kubernetes Job deployment for automated snapshot capture.
Package agent provides Kubernetes Job deployment for automated snapshot capture.
client
Package client provides a singleton Kubernetes client for efficient cluster interactions.
Package client provides a singleton Kubernetes client for efficient cluster interactions.
k8stest
Package k8stest provides test helpers that run against an envtest API server.
Package k8stest provides test helpers that run against an envtest API server.
labels
Package labels provides shared Kubernetes label constants used by both the validator (pkg/validator) and the snapshot agent (pkg/k8s/agent), so neither has to import the other to agree on label keys and values.
Package labels provides shared Kubernetes label constants used by both the validator (pkg/validator) and the snapshot agent (pkg/k8s/agent), so neither has to import the other to agree on label keys and values.
pod
Package pod provides shared utilities for Kubernetes Job and Pod operations.
Package pod provides shared utilities for Kubernetes Job and Pod operations.
Package logging provides structured logging utilities for AICR components.
Package logging provides structured logging utilities for AICR components.
Package manifest provides Helm-compatible template rendering for manifest files.
Package manifest provides Helm-compatible template rendering for manifest files.
Package measurement provides types and utilities for collecting, comparing, and filtering system measurements from various sources (Kubernetes, GPU, OS, SystemD, NodeTopology, NetworkTopology).
Package measurement provides types and utilities for collecting, comparing, and filtering system measurements from various sources (Kubernetes, GPU, OS, SystemD, NodeTopology, NetworkTopology).
Package mirror discovers container images and Helm charts referenced by a recipe and emits the list in formats consumable by air-gap tools (Hauler, Zarf) and general-purpose formats (JSON, YAML).
Package mirror discovers container images and Helm charts referenced by a recipe and emits the list in formats consumable by air-gap tools (Hauler, Zarf) and general-purpose formats (JSON, YAML).
Package netutil holds small, dependency-free networking helpers shared across packages that have no other reason to depend on one another (e.g.
Package netutil holds small, dependency-free networking helpers shared across packages that have no other reason to depend on one another (e.g.
Package oci provides functionality for packaging and pushing artifacts to OCI-compliant registries.
Package oci provides functionality for packaging and pushing artifacts to OCI-compliant registries.
operator
aicrjob
Package aicrjob runs AICR as pinned-image Jobs and parses its frozen artifacts: Job specs, run IDs, the version gate, exit-code mapping, and operator-owned types for Snapshot, RecipeResult, the Helm bundle layout and the upgrade-check report, validated against AICR's published schemas.
Package aicrjob runs AICR as pinned-image Jobs and parses its frozen artifacts: Job specs, run IDs, the version gate, exit-code mapping, and operator-owned types for Snapshot, RecipeResult, the Helm bundle layout and the upgrade-check report, validated against AICR's published schemas.
config
Package config holds the operator's installation configuration: the infrastructure the chart sets as values and passes as flags (api.md installation values).
Package config holds the operator's installation configuration: the infrastructure the chart sets as values and passes as flags (api.md installation values).
controller
Package controller hosts the resolver, rollout and credentials controllers as thin adapters over the functional packages.
Package controller hosts the resolver, rollout and credentials controllers as thin adapters over the functional packages.
defaults
Package defaults holds the operator's named defaults and limits, so no timeout or bound is an unexplained literal at a call site.
Package defaults holds the operator's named defaults and limits, so no timeout or bound is an unexplained literal at a call site.
discovery
Package discovery observes Nodes for group membership and homogeneity and orchestrates AICR snapshot and recipe Jobs.
Package discovery observes Nodes for group membership and homogeneity and orchestrates AICR snapshot and recipe Jobs.
engine/argocd
Package argocd implements the engine adapter contract for Argo CD, including current-revision readiness without observedGeneration.
Package argocd implements the engine adapter contract for Argo CD, including current-revision readiness without observedGeneration.
engine/flux
Package flux implements the engine adapter contract for Flux, a follow-on to the Argo CD adapter.
Package flux implements the engine adapter contract for Flux, a follow-on to the Argo CD adapter.
errors
Package errors provides the operator's structured errors.
Package errors provides the operator's structured errors.
evidence
Package evidence binds AICR's deployment validation evidence to what the operator rolled out.
Package evidence binds AICR's deployment validation evidence to what the operator rolled out.
lifecycle
Package lifecycle implements transition assessment, approval and revocation, removal, orphaning and re-adoption.
Package lifecycle implements transition assessment, approval and revocation, removal, orphaning and re-adoption.
manager
Package manager builds the controller-runtime manager that hosts the operator's controllers.
Package manager builds the controller-runtime manager that hosts the operator's controllers.
plan
Package plan parses rendered AICR output into plan documents, computes desiredStateDigest and inputDigest, rebuilds plans from live engine objects, and constructs rollout steps.
Package plan parses rendered AICR output into plan documents, computes desiredStateDigest and inputDigest, rebuilds plans from live engine objects, and constructs rollout steps.
plugin
Package plugin implements the kubectl aicr plugin: describe, approve, acknowledge and revoke rollouts (api.md#approval), and reproduce a plan's bundle with the AICR CLI.
Package plugin implements the kubectl aicr plugin: describe, approve, acknowledge and revoke rollouts (api.md#approval), and reproduce a plan's bundle with the AICR CLI.
registry
Package registry mirrors pinned upstream charts, packages wrapper charts deterministically, and brokers registry credentials.
Package registry mirrors pinned upstream charts, packages wrapper charts deterministically, and brokers registry credentials.
registry/registrytest
Package registrytest serves in-memory OCI registries, and fakes ECR's token API, for tests.
Package registrytest serves in-memory OCI registries, and fakes ECR's token API, for tests.
resolver
Package resolver turns runtime intent into a plan: it maps ClusterRuntime fields onto AICR recipe and bundle arguments, computes the resolution inputDigest, and assembles the plan from a rendered bundle.
Package resolver turns runtime intent into a plan: it maps ClusterRuntime fields onto AICR recipe and bundle arguments, computes the resolution inputDigest, and assembles the plan from a rendered bundle.
version
Package version reports the build identity stamped into the operator binaries at link time.
Package version reports the build identity stamped into the operator binaries at link time.
Package recipe provides recipe building and matching functionality.
Package recipe provides recipe building and matching functionality.
catalog
Package catalog provides signing and verification for the AICR recipe catalog (registry.yaml + validators/catalog.yaml).
Package catalog provides signing and verification for the AICR recipe catalog (registry.yaml + validators/catalog.yaml).
ocisource
Package ocisource provides an owned recipe.DataProvider backed by one immutable-digest-selected OCI recipe artifact.
Package ocisource provides an owned recipe.DataProvider backed by one immutable-digest-selected OCI recipe artifact.
oskind
Package oskind is the single source of truth for the string values of the OS recipe criterion.
Package oskind is the single source of truth for the string values of the OS recipe criterion.
providertest
Package providertest provides a recipe.DataProvider over an fs.FS and a writer for --data directories, for tests.
Package providertest provides a recipe.DataProvider over an fs.FS and a writer for --data directories, for tests.
recipetest
Package recipetest provides recipe-data fixtures for tests in other packages.
Package recipetest provides recipe-data fixtures for tests in other packages.
Package runid generates unique run identifiers shared by the validator and the snapshot agent so both subsystems use one format and one generator.
Package runid generates unique run identifiers shared by the validator and the snapshot agent so both subsystems use one format and one generator.
Package schema derives JSON Schema documents from the Go types that define AICR's published artifacts.
Package schema derives JSON Schema documents from the Go types that define AICR's published artifacts.
Package serializer provides encoding and decoding of measurement data in multiple formats.
Package serializer provides encoding and decoding of measurement data in multiple formats.
Package server implements the aicrd HTTP server: the AICR System Configuration Recommendation API defined in api/aicr/v1/server.yaml.
Package server implements the aicrd HTTP server: the AICR System Configuration Recommendation API defined in api/aicr/v1/server.yaml.
Package snapshotter captures comprehensive system configuration snapshots.
Package snapshotter captures comprehensive system configuration snapshots.
Package testgrid maps a recipe's canonical coordinate to the AICR evidence dashboard (validation.aicr.run) and answers "does this coordinate have a dashboard presence?" — the two facts RQ1 (#1283) and RQ2 (#1284) share.
Package testgrid maps a recipe's canonical coordinate to the AICR evidence dashboard (validation.aicr.run) and answers "does this coordinate have a dashboard presence?" — the two facts RQ1 (#1283) and RQ2 (#1284) share.
Package trust manages Sigstore trusted root material for offline attestation verification.
Package trust manages Sigstore trusted root material for offline attestation verification.
Package tuning computes the nodewright tuning-status matrix: for each (service, accelerator) the catalog resolves, which tuning profile is applied and the pinned versions of the nodewright nvidia-setup / nvidia-tuned / nvidia-tuning-gke packages.
Package tuning computes the nodewright tuning-status matrix: for each (service, accelerator) the catalog resolves, which tuning profile is applied and the pinned versions of the nodewright nvidia-setup / nvidia-tuned / nvidia-tuning-gke packages.
Package uatbroker resolves the UAT reservation registry (infra/uat/reservations.yaml) and expands the nightly version-matrix schedule for the day/night UAT broker (#1274).
Package uatbroker resolves the UAT reservation registry (infra/uat/reservations.yaml) and expands the nightly version-matrix schedule for the day/night UAT broker (#1274).
Package upgrade implements ADR-021 component upgrade transition records.
Package upgrade implements ADR-021 component upgrade transition records.
Package validator evaluates a recipe's constraints and validation checks against a cluster snapshot and the live cluster.
Package validator evaluates a recipe's constraints and validation checks against a cluster snapshot and the live cluster.
catalog
Package catalog provides the declarative validator catalog.
Package catalog provides the declarative validator catalog.
ctrf
Package ctrf provides Go types and utilities for the Common Test Report Format (CTRF).
Package ctrf provides Go types and utilities for the Common Test Report Format (CTRF).
job
labels
Package labels provides shared label constants for validation resources.
Package labels provides shared label constants for validation resources.
v1
Package v1 defines AICR's validator input format (v1alpha1).
Package v1 defines AICR's validator input format (v1alpha1).
Package version provides semantic version parsing and comparison with flexible precision support.
Package version provides semantic version parsing and comparison with flexible precision support.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL