controlplane

package
v1.0.0 Latest Latest
Warning

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

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

Documentation

Overview

Package controlplane defines the declarative governance control plane for MIDAS.

The control plane is responsible for describing and managing the governed resources that shape agent execution authority, including:

  • Surfaces: governed action boundaries
  • Agents: non-human or system identities
  • Profiles: authority policies and execution constraints
  • Grants: bindings that assign profiles to agents

In this model, control-plane resources are authored as documents, parsed from YAML, validated against MIDAS rules, and then applied into the system.

Package structure

Subpackages are organised by responsibility:

  • types: core document and result types
  • parser: YAML parsing into typed control-plane documents
  • validate: document and bundle validation
  • apply: planning and execution of validated bundles

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Service

type Service struct {
	// contains filtered or unexported fields
}

Service provides the top-level control-plane workflow for MIDAS.

It is the orchestration façade over parsing and apply. Callers provide either raw YAML or pre-parsed documents and receive a structured ApplyResult.

func NewService

func NewService() *Service

NewService constructs a control-plane service using the default apply behavior.

func NewServiceWithRepository

func NewServiceWithRepository(_ any) *Service

NewServiceWithRepository constructs a control-plane service without a backing repository. The parameter is accepted for interface compatibility.

func (*Service) ApplyDocuments

func (s *Service) ApplyDocuments(ctx context.Context, docs []parser.ParsedDocument) types.ApplyResult

ApplyDocuments applies an already-parsed bundle of control-plane documents.

func (*Service) ApplyYAML

func (s *Service) ApplyYAML(ctx context.Context, data []byte) types.ApplyResult

ApplyYAML parses a YAML bundle and applies it through the control plane.

Directories

Path Synopsis
Package apply applies validated MIDAS control-plane documents.
Package apply applies validated MIDAS control-plane documents.

Jump to

Keyboard shortcuts

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