status

Documentation

Overview

Package status provides task index status reporting.

Index

• type AggregateMetrics
• type PlanningStepSummary
• type StatusRow
  • func NewSeparatorRow() StatusRow
  • func (r StatusRow) Attrs() string
  • func (r StatusRow) ID() string
  • func (r StatusRow) PID() string
  • func (r StatusRow) Role() string
  • func (r StatusRow) Runtime() string
  • func (r StatusRow) State() string
  • func (r StatusRow) Title() string
• type Summary
  • func GetSummary(repoRoot string) (Summary, error)
  • func (s Summary) String() string
  • func (s Summary) StringWithMerged(includeMerged bool) string
• type SupervisorSummary
• type WorkerSummary

Types

type AggregateMetrics

type AggregateMetrics struct {
	TotalDurationMs   int64 // Sum of all DurationMs + elapsed time for in-flight
	TotalTokensPrompt int   // Sum of TokensPrompt
	TotalTokensOutput int   // Sum of TokensResponse
	TotalTokens       int   // Sum of TokensTotal
}

AggregateMetrics holds cumulative metrics across all tasks.

type PlanningStepSummary

type PlanningStepSummary struct {
	ID        string
	Name      string
	Status    string
	Order     int
	PID       int       // From supervisor if this step is currently running
	StartedAt time.Time // From supervisor if this step is currently running
}

PlanningStepSummary captures the status output for a planning step.

type StatusRow

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

StatusRow represents a single task row in the status display.

func NewSeparatorRow

func NewSeparatorRow() StatusRow

NewSeparatorRow creates an empty row used as a visual separator.

func (StatusRow) Attrs

func (r StatusRow) Attrs() string

func (StatusRow) ID

func (r StatusRow) ID() string

Accessor methods for StatusRow (used by TUI package)

func (StatusRow) PID

func (r StatusRow) PID() string

func (StatusRow) Role

func (r StatusRow) Role() string

func (StatusRow) Runtime

func (r StatusRow) Runtime() string

func (StatusRow) State

func (r StatusRow) State() string

func (StatusRow) Title

func (r StatusRow) Title() string

type Summary

type Summary struct {
	Supervisors   []SupervisorSummary
	Workers       []WorkerSummary
	PlanningSteps []PlanningStepSummary
	Total         int
	Backlog       int
	Merged        int
	InProgress    int
	Rows          []StatusRow // Active (non-merged) tasks
	MergedRows    []StatusRow // Merged tasks (kept separate)
	Aggregates    AggregateMetrics
}

Summary represents task counts and the in-progress table.

func GetSummary

func GetSummary(repoRoot string) (Summary, error)

GetSummary reads the task index and returns a detailed summary.

func (Summary) String

func (s Summary) String() string

String returns the formatted status output per flow.md. Uses styled output for TTY, plain output for pipes/redirects.

func (Summary) StringWithMerged

func (s Summary) StringWithMerged(includeMerged bool) string

StringWithMerged returns formatted status output and optionally includes merged tasks.

type SupervisorSummary

type SupervisorSummary struct {
	Phase          string
	State          string
	PID            int
	WorkerPID      int
	ValidationPID  int
	StepID         string
	StepName       string
	StartedAt      time.Time
	LastTransition time.Time
	LogPath        string
}

SupervisorSummary captures the status output for a supervisor.

type WorkerSummary

type WorkerSummary struct {
	PID       int
	Role      string
	StartedAt time.Time
}

WorkerSummary captures the status output for an active worker.