ports

type ActionDispatcher interface {
	Dispatch(req domain.ActionRequest) (domain.ActionResponse, error)
}

type GraphLoader interface {
	// GetNode retrieves the raw definition of a node by ID.
	// It returns the raw bytes (which the compiler will parse) or an error.
	GetNode(id string) ([]byte, error)

	// ListNodes returns a simplified list of all node IDs available in the graph.
	// This is used for introspection and visualization tools (e.g. 'trellis graph').
	ListNodes() ([]string, error)
}

type Watchable interface {
	// Watch returns a channel that is signaled when the underlying graph changes.
	// It returns a string (the event type, e.g. "reload") or an error.
	Watch(ctx context.Context) (<-chan string, error)
}