pipeline

type DefinitionRef struct {
	// Workflow is the workflow name in specification-workflow-spec
	// (e.g., "aws-one-way-door").
	Workflow string `json:"workflow" yaml:"workflow" jsonschema:"required,description=Definition workflow name"`

	// Outputs lists the spec type IDs handed off downstream
	// (e.g., ["narrative-6p", "prd", "trd"]).
	Outputs []string `json:"outputs,omitempty" yaml:"outputs,omitempty" jsonschema:"description=Spec type IDs handed off downstream"`
}

type ExecutionRef struct {
	// Integration is the integration ID (e.g., "ai-dlc").
	Integration string `json:"integration" yaml:"integration" jsonschema:"required,description=Execution integration ID"`

	// InputPort is the ID of the integration input Port that receives the
	// handoff, if a specific one applies.
	InputPort string `` /* 132-byte string literal not displayed */
}

type Handoff struct {
	// SpecType is the definition-side spec type ID (e.g., "trd").
	SpecType string `json:"spec_type" yaml:"spec_type" jsonschema:"required,description=Definition-side spec type ID"`

	// ToArtifact is the execution-side artifact ID (or input port ID) the spec
	// feeds into.
	ToArtifact string `` /* 134-byte string literal not displayed */

	// Transform notes any mapping or transformation applied at the seam
	// (e.g., "flatten to a single requirements.md").
	Transform string `json:"transform,omitempty" yaml:"transform,omitempty" jsonschema:"description=Note on any transform applied at the seam"`
}

type Pipeline struct {
	// ID is the canonical identifier (e.g., "aws-one-way-door-to-ai-dlc").
	ID string `json:"id" yaml:"id" jsonschema:"required,description=Canonical identifier for the pipeline"`

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

	// Description explains the pipeline and when to use it.
	Description string `json:"description,omitempty" yaml:"description,omitempty" jsonschema:"description=Pipeline purpose and use case"`

	// Definition is the upstream definition-side workflow.
	Definition DefinitionRef `json:"definition" yaml:"definition" jsonschema:"required,description=Upstream definition workflow"`

	// Execution is the downstream execution-side integration.
	Execution ExecutionRef `json:"execution" yaml:"execution" jsonschema:"required,description=Downstream execution integration"`

	// Handoffs map individual definition-side spec types onto execution-side
	// artifacts or input ports.
	Handoffs []Handoff `json:"handoffs,omitempty" yaml:"handoffs,omitempty" jsonschema:"description=Per-spec-type handoff mappings"`

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