runtimeprofile

package
v0.55.18 Latest Latest
Warning

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

Go to latest
Published: Nov 5, 2026 License: Apache-2.0 Imports: 16 Imported by: 0

Documentation

Overview

Package runtimeprofile connects each StackKits entry point to the shared self-hosted data-profile policy. Locality policy remains in go-common.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AdmitSpec

func AdmitSpec(value string) error

AdmitSpec binds native lifecycle admission to the persisted selection. It never repairs a mismatch by changing the environment or rewriting intent.

func BeginRILAuthorityApply

func BeginRILAuthorityApply() (func(), error)

BeginRILAuthorityApply serializes activation against active hosted dials. Acquire before any workspace or output lock; retain it through Apply and authority publication. Invalidation happens after plan verification.

func Boot

func Boot() error

Boot validates the edition/profile before any runtime work and installs the shared HTTP/DNS guard. Custom transports and subprocesses retain their own admitted local destinations; this does not claim an operating-system firewall.

func FullLocal

func FullLocal() bool

FullLocal is queried only after Boot has validated the process environment.

func InvalidateRILAuthority

func InvalidateRILAuthority() error

InvalidateRILAuthority runs before Product Apply. A failed or interrupted apply cannot leave the preceding hosted-profile grant usable. A system without the privileged Guard has no RIL authority to invalidate.

func PublishRILAuthority

func PublishRILAuthority(workspace, planHash, resultHash, expiresAt string, paths []string, verified [][]byte) error

func RILCanonicalWorkspace

func RILCanonicalWorkspace(workspace string) bool

Only the executor's canonical workspace can publish the host authority. Admitted descendants still invalidate the previous authority before Apply.

func RILWorkspaceConfigured

func RILWorkspaceConfigured() bool

RILWorkspaceConfigured is set only by the privileged Guard executor.

func ReadRILEvidence

func ReadRILEvidence(workspace, name string) ([]byte, error)

ReadRILEvidence accepts only root-owned, non-writable directory chains and single-link regular files; it never follows a symlink. This is also used for the evidence recheck immediately before publishing the root assertion.

func ValidateLocalDNS

func ValidateLocalDNS(servers []string) error

Types

type DataProfile

type DataProfile string

DataProfile is the persisted StackSpec selection carried by a verified plan. Its zero value is the backward-compatible Standard profile.

const (
	StandardProfile  DataProfile = "standard"
	FullLocalProfile DataProfile = dataprofile.FullLocal
)

func FromBootEnv

func FromBootEnv() (DataProfile, error)

FromBootEnv validates the shared edition/profile policy for initial authoring.

func Parse

func Parse(value string) (DataProfile, error)

Parse accepts canonical intent only; an absent field retains Standard.

func (DataProfile) FullLocal

func (p DataProfile) FullLocal() bool

type LocalNetwork

type LocalNetwork struct {
	StackID  string   `json:"stackId"`
	Resolver string   `json:"resolver"`
	Upstream []string `json:"upstream"`
}

LocalNetwork is compiler-owned cohort identity and DNS transport. The resolver is the attested node's signed LAN DNS service, not a host default.

func (LocalNetwork) Validate

func (p LocalNetwork) Validate() error

type OfflineBundleRef

type OfflineBundleRef struct {
	Path           string `json:"path" yaml:"path"`
	ManifestSHA256 string `json:"manifestSha256" yaml:"manifestSha256"`
}

OfflineBundleRef identifies immutable installation input. This reference never replaces release attestation or verification of the complete bundle.

func (OfflineBundleRef) Validate

func (r OfflineBundleRef) Validate() error

Validate checks the portable Linux mount reference, without reading files or implying trust. Restricting characters keeps Compose interpolation literal.

type RILEvidence

type RILEvidence struct {
	Path   string `json:"path"`
	Digest string `json:"digest"`
}

RILEvidence binds exact bytes that have already passed product verification.

Jump to

Keyboard shortcuts

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