playbooks

type ArchonLoop struct {
	Prompt        string
	Until         string
	MaxIterations int
	FreshContext  bool
	Interactive   bool
}

type ArchonNode struct {
	// ID is the node's `id:` field. Empty IDs are tolerated for
	// hand-edited drafts (Archon itself rejects them at run time).
	ID string

	// Kind is one of:
	//   "prompt"  — `prompt: ...` (AI step)
	//   "bash"    — `bash: ...`   (deterministic shell step)
	//   "loop"    — `loop: { prompt, until, max_iterations, ... }`
	//   "command" — `command: archon-<slug>` (slash-command dispatch)
	//   "unsupported:<original-key>" — recognised but not yet supported
	//     (e.g. "unsupported:parallel"). Phase 2 wires these.
	Kind string

	// Prompt is populated when Kind == "prompt".
	Prompt string

	// Bash is populated when Kind == "bash".
	Bash string

	// Loop is populated when Kind == "loop". Pointer so the zero
	// value is unambiguously "not a loop".
	Loop *ArchonLoop

	// Command is populated when Kind == "command".
	Command string

	// DependsOn mirrors the YAML `depends_on:` list. Phase 2 uses
	// this for DAG traversal; phase 1 only carries it through.
	DependsOn []string
}

type ArchonWorkflow struct {
	// Name is the workflow's `name:` field. Defaults to the file's
	// basename (sans .yaml) when missing so list output stays
	// useful for unnamed drafts.
	Name string

	// Description is `description:` (often a multi-line block scalar
	// in upstream defaults). May be empty.
	Description string

	// Path is the absolute path the workflow was loaded from.
	// Surfaced so phase 2 can re-open the file for execution.
	Path string

	// Nodes preserves source order. DAG topology lives in the YAML
	// (`depends_on` per node); we don't resolve it at parse time.
	Nodes []ArchonNode
}