PhaseEnum

Description:

public enum PhaseEnum

Which task-list or executor phase is active for markdown generation, link validation, and (on restore) transcript replay.

Prompt / markdown: Details.to_markdown, Step.to_markdown, and List.to_markdown take a PhaseEnum to include the right sections (e.g. tool calls, result summary, references). Validation: ValidateLink and ResolveLink branch on stage so list vs refinement vs executor output get the correct rules.

Live wire ids: the skill runner adds agent-stage messages whose body is a short id (task_list_parse, refinement , exec, …). from_string maps those strings here; to_string maps back for stages the live flow emits (others yield ).

Markdown and planning phases

COARSE / REFINEMENT / LIST — task list and refinement: coarse creation keys,
refined task block, or outstanding list (+ optional executor result summary when

exec_done) for prompts.
REFINE_COMPLETED — completed-task markdown for iteration prompts (omits certain
reference sections; see Details.to_markdown).
EXECUTION / POST_EXEC — executor LLM output vs post-exec synthesis; used in
ResultParser.exec_extract, ResultParser.exec_post_extract, and matching

ValidateLink behavior.

Replay-only and sentinel

NONE — not a live stage: from_string default for unknown ids; GTK replay uses
it only until the first agent-stage applies.
TASK_LIST_ITERATION — parsing a revised list ( ResultParser.parse_task_list_iteration).
EXEC_VALIDATE — validating executor writes after exec; replay cursor advances here
while consuming exec_validate / validate agent-issues rows.

Content:

Enum values:

COARSE - Task list creation keys only (initial planning shape); see Details.to_markdown.
COMPLETED - Progress UI: row finished (task or tool pass).
COMPLETED_DONE - Step list boundary: Step has been removed from Runner#pending and appended to Runner#completed. Unlike COMPLETED, this marks the container step only; each task row still uses Details#status for its own stage.
ERROR - Progress UI: retries exhausted or unrecoverable failure (Tool.run, OLLMcoder.Skill.Runner.send_async, OLLMcoder.Skill.Runner.run_task_list_iteration).
EXECUTION - Executor LLM output (Result summary, tool calls); Tool.run and ResultParser.exec_extract.
EXECUTION_RETRY - Progress UI: same executor pass retrying after send / parse / validate failure (Tool.run loop).
EXEC_VALIDATE - Post-exec validation of writes; pairs with wire exec_validate and replay validate steps.
EXEC_WRITE - Progress UI: applying parsed write_file operations (Tool.run).
LIST - Outstanding task list markdown (iteration / execution context); may include task result output when exec_done.
LIST_RETRY - Progress UI: task list creation retry after parse failure ( OLLMcoder.Skill.Runner.send_async).
NONE - Sentinel: unknown stage id, or replay bootstrap before the first agent-stage message.
POST_EXEC - Post-execution synthesis (ResultParser.exec_post_extract, Details.run_post_exec).
REFINED - Progress UI: refinement parse succeeded; awaiting **`run_exec`** (or **`wait_refined`** resume). Not shown in the status column — to_human returns empty (same as NONE for display).
REFINEMENT - Refined task block; refinement prompts and bounded file previews in references.
REFINEMENT_RETRY - Progress UI: refinement parse failed; another refinement attempt will run ( Details.refine outer loop). to_human — **Refinement Retrying** (task row shows task name in the other column).
REFINE_COMPLETED - Completed tasks aggregate for prompts (e.g. task list iteration); not a wire agent-stage id.
STOPPED - Progress UI: user cancelled the in-flight request. Set from cancel paths when the row would otherwise clear to NONE; never overwrites an existing ERROR.
TASK_LIST_ITERATION - Revised task list from iteration; pairs with wire task_list_iteration.
TASK_LIST_ITERATION_RETRY - Progress UI: task list iteration retry after parse failure ( OLLMcoder.Skill.Runner.run_task_list_iteration).
TOOLS_RUNNING - Progress UI: native tool hook in flight (Tool.run).

Static methods:

public static PhaseEnum from_string (string id)
Map a persisted agent-stage message body to a phase (e.g. task_list_parse → LIST).

Methods:

public string to_human ()
Pango markup for the progress stage column ( ProgressItem.status_str). Gtk: enable markup on the cell/renderer that binds **status-str**.
public string to_string ()
Stable wire id for agent-stage messages for phases the live flow emits.