synthesis

type DAG struct {
	// Nodes are the spec type IDs in topological order.
	Nodes []string `json:"nodes" jsonschema:"required,description=Spec types in topological order"`

	// Edges are source->target dependencies.
	Edges []Edge `json:"edges" jsonschema:"required,description=Dependency edges"`
}

type Edge struct {
	// Source is the upstream spec type ID.
	Source string `json:"source" jsonschema:"required,description=Upstream spec type"`

	// Target is the downstream spec type ID (synthesized from source).
	Target string `json:"target" jsonschema:"required,description=Downstream spec type"`
}

type Rule struct {
	// Sources are the spec type IDs required to synthesize this spec.
	Sources []string `json:"sources" jsonschema:"required,description=Source spec type IDs"`

	// Guidance is the prompt context for LLM synthesis.
	Guidance string `json:"guidance,omitempty" jsonschema:"description=LLM prompt guidance for synthesis"`

	// PromptContext is additional context for the synthesis prompt.
	PromptContext string `json:"prompt_context,omitempty" jsonschema:"description=Additional synthesis prompt context"`

	// Required indicates all sources must be present (vs. best-effort).
	Required bool `json:"required,omitempty" jsonschema:"description=Whether all sources are required"`

	// Priority determines synthesis order when multiple rules exist.
	Priority int `json:"priority,omitempty" jsonschema:"description=Synthesis priority (higher = earlier)"`
}