loop

type Actor string

type GateAuthority string

type Loop struct {
	// ID is the loop identifier, unique within the system (e.g., "product").
	ID string `json:"id" yaml:"id" jsonschema:"required,description=Loop identifier (unique within the system)"`

	// Name is the human-readable name (e.g., "Product Loop").
	Name string `json:"name" yaml:"name" jsonschema:"required,description=Loop name"`

	// Owner is the accountable role (e.g., "Product person", "Builder").
	Owner string `json:"owner,omitempty" yaml:"owner,omitempty" jsonschema:"description=Accountable role"`

	// Question is the loop's verification question (e.g., "Right thing?").
	Question string `json:"question,omitempty" yaml:"question,omitempty" jsonschema:"description=The loop's verification question"`

	// Description explains the loop.
	Description string `json:"description,omitempty" yaml:"description,omitempty" jsonschema:"description=Loop purpose"`

	// Stations are the ordered steps; the last cycles back to the first.
	Stations []Station `json:"stations" yaml:"stations" jsonschema:"required,description=Ordered stations (last cycles back to first)"`
}

type Seam struct {
	// From is the source station reference as "loopID.stationID".
	From string `json:"from" yaml:"from" jsonschema:"required,description=Source station as loopID.stationID"`

	// To is the destination station reference as "loopID.stationID".
	To string `json:"to" yaml:"to" jsonschema:"required,description=Destination station as loopID.stationID"`

	// Artifact names what crosses the seam (e.g., "Product Baseline").
	Artifact string `json:"artifact,omitempty" yaml:"artifact,omitempty" jsonschema:"description=What crosses the seam"`

	// Description explains the seam.
	Description string `json:"description,omitempty" yaml:"description,omitempty" jsonschema:"description=Seam explanation"`
}

type Station struct {
	// ID is the station identifier, unique within the loop (e.g., "define").
	ID string `json:"id" yaml:"id" jsonschema:"required,description=Station identifier (unique within the loop)"`

	// Name is the human-readable name (e.g., "Define").
	Name string `json:"name" yaml:"name" jsonschema:"required,description=Station name"`

	// Actor performs the station's work.
	Actor Actor `json:"actor" yaml:"actor" jsonschema:"required,enum=human,enum=ai,enum=human+ai"`

	// Description explains the station.
	Description string `json:"description,omitempty" yaml:"description,omitempty" jsonschema:"description=Station purpose"`

	// Gate marks this station as an approval checkpoint.
	Gate bool `json:"gate,omitempty" yaml:"gate,omitempty" jsonschema:"description=True if this station is an approval checkpoint"`

	// GateAuthority is the default approval authority when Gate is true.
	GateAuthority GateAuthority `` /* 156-byte string literal not displayed */

	// AutonomyNote describes how the station changes as autonomy (ASDM level)
	// rises (e.g., "human at L5 and below; policy-gated at L6+").
	AutonomyNote string `` /* 128-byte string literal not displayed */

	// SpecTypes lists spec type IDs produced or consumed at this station.
	SpecTypes []string `json:"spec_types,omitempty" yaml:"spec_types,omitempty" jsonschema:"description=Spec type IDs produced or consumed here"`

	// Workflows lists definition workflow names that operate at this station.
	Workflows []string `` /* 127-byte string literal not displayed */

	// Integrations lists execution integration IDs that operate at this station.
	Integrations []string `` /* 133-byte string literal not displayed */
}

type System struct {
	// ID is the canonical identifier (e.g., "pbhq-two-loop", "aws-ai-dlc").
	ID string `json:"id" yaml:"id" jsonschema:"required,description=Canonical identifier for the loop system"`

	// Name is the human-readable name.
	Name string `json:"name" yaml:"name" jsonschema:"required,description=Human-readable name"`

	// Vendor is the defining organization (e.g., "ProductBuildersHQ", "AWS").
	Vendor string `json:"vendor,omitempty" yaml:"vendor,omitempty" jsonschema:"description=Defining organization"`

	// Description explains the system.
	Description string `json:"description,omitempty" yaml:"description,omitempty" jsonschema:"description=System purpose and scope"`

	// Reference is a URL to canonical documentation.
	Reference string `json:"reference,omitempty" yaml:"reference,omitempty" jsonschema:"format=uri,description=Documentation URL"`

	// Loops are the cycles in this system, outermost first.
	Loops []Loop `json:"loops" yaml:"loops" jsonschema:"required,description=Cycles in this system (outermost first)"`

	// Seams connect stations across loops.
	Seams []Seam `json:"seams,omitempty" yaml:"seams,omitempty" jsonschema:"description=Cross-loop connections"`
}