conformance

Documentation

Overview

Package conformance provides the canonical Toolbox protocol fixture and the reusable host harness that certifies a toolbox implementation. It intentionally depends only on core contracts, never on CLI composition.

Index

• Constants
• type Server
  • func New(version string) *Server
  • func (s *Server) DescribeTool(ctx context.Context, req *toolboxv0.DescribeToolRequest) (*toolboxv0.DescribeToolResponse, error)
  • func (s *Server) Tools() []*registry.ToolDefinition

Constants

const (
	FixtureName            = "conformance-fixture"
	FixtureVersion         = "0.0.1"
	ContractVersion        = "codefly.toolbox.conformance/v1"
	IdentityTool           = "fixture.identity.describe"
	DeterministicErrorTool = "fixture.error.deterministic"
	EffectIncrementTool    = "fixture.effect.increment"
	EffectCountTool        = "fixture.effect.count"
	WaitTool               = "fixture.wait"
	CrashTool              = "fixture.process.crash"
	DeterministicError     = "fixture: deterministic error v1"

	// FaultEnvironment selects one deterministic V4 lifecycle fault for the
	// disposable process. It is intentionally fixture-only and never read by
	// production toolboxes.
	FaultEnvironment           = "CODEFLY_CONFORMANCE_FAULT"
	FaultBeforeAuthorization   = "before_authorization"
	FaultAfterAuthorization    = "after_authorization"
	FaultDuringExecution       = "during_execution"
	FaultAfterSideEffect       = "after_side_effect"
	FaultResponseSerialization = "response_serialization"
)

Types

type Server

type Server struct {
	*registry.Base
	// contains filtered or unexported fields
}

Server is deterministic except for its deliberately observable in-memory effect counter. The counter lets a host prove a denied destructive call never reached the handler without touching the filesystem or an external service.

func New

func New(version string) *Server

func (*Server) DescribeTool

func (s *Server) DescribeTool(ctx context.Context, req *toolboxv0.DescribeToolRequest) (*toolboxv0.DescribeToolResponse, error)

DescribeTool injects the only pre-authorization process failure in the fixture. The host has selected a summary but has not yet approved a descriptor or minted authority when this process exits.

func (*Server) Tools

func (s *Server) Tools() []*registry.ToolDefinition

Tools returns the stable v1 fixture catalog. Renaming or reordering these tools is a protocol change and is protected by the JSON/protobuf golden test.