workflow

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

type DOTRenderer struct {
	// RankDir: TB, LR, BT, RL
	RankDir string
	// ShowStatus includes status indicators
	ShowStatus bool
	// Cluster groups nodes by phase
	Cluster bool
}

type JSONRenderer struct {
	Indent bool
}

type MermaidRenderer struct {
	// Direction: TB (top-bottom), LR (left-right), BT, RL
	Direction string
	// ShowStatus includes status indicators
	ShowStatus bool
	// ShowPhases groups nodes by phase
	ShowPhases bool
}

type Node struct {
	// ID uniquely identifies the node
	ID string `json:"id" yaml:"id"`

	// Name is the display name
	Name string `json:"name" yaml:"name"`

	// Description provides context
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Type categorizes the node (domain-specific, e.g., "source", "gtm", "technical")
	Type NodeType `json:"type,omitempty" yaml:"type,omitempty"`

	// Phase is the phase ID this node belongs to
	Phase string `json:"phase" yaml:"phase"`

	// DependsOn lists node IDs that must complete before this node can start
	DependsOn []string `json:"depends_on,omitempty" yaml:"depends_on,omitempty"`

	// Status is the current state of the node
	Status Status `json:"status" yaml:"status"`

	// Automated indicates if this node is machine-generated vs human-authored
	Automated bool `json:"automated,omitempty" yaml:"automated,omitempty"`

	// Metadata holds domain-specific data
	Metadata map[string]any `json:"metadata,omitempty" yaml:"metadata,omitempty"`
}

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

type NodeType string

type Phase struct {
	// ID uniquely identifies the phase
	ID string `json:"id" yaml:"id"`

	// Name is the display name
	Name string `json:"name" yaml:"name"`

	// Description provides context
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Order determines phase sequence (lower = earlier)
	Order int `json:"order" yaml:"order"`

	// Nodes lists the node IDs in this phase
	Nodes []string `json:"nodes" yaml:"nodes"`
}

type Renderer interface {
	Render(w *Workflow) string
}

type Status string

type Workflow struct {
	// Name identifies the workflow (e.g., "aws-working-backwards", "big-tech-product")
	Name string `json:"name" yaml:"name"`

	// Description provides human-readable context
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Phases define logical groupings/stages in order
	Phases []Phase `json:"phases" yaml:"phases"`

	// Nodes are the work items in the workflow
	Nodes map[string]*Node `json:"nodes" yaml:"nodes"`
}