processor

type Config ¶

type Config struct {
	PlanFile         string         // path to plan file (required for full mode)
	PlanDescription  string         // plan description for interactive plan creation mode
	ProgressPath     string         // path to progress file
	Mode             Mode           // execution mode
	MaxIterations    int            // maximum iterations for task phase
	Debug            bool           // enable debug output
	NoColor          bool           // disable color output
	IterationDelayMs int            // delay between iterations in milliseconds
	TaskRetryCount   int            // number of times to retry failed tasks
	CodexEnabled     bool           // whether codex review is enabled
	FinalizeEnabled  bool           // whether finalize step is enabled
	DefaultBranch    string         // default branch name (detected from repo)
	AppConfig        *config.Config // full application config (for executors and prompts)
}

Config holds runner configuration.

type Executor ¶

type Executor interface {
	Run(ctx context.Context, prompt string) executor.Result
}

Executor runs CLI commands and returns results.

type InputCollector ¶ added in v0.4.0

type InputCollector interface {
	AskQuestion(ctx context.Context, question string, options []string) (string, error)
	AskDraftReview(ctx context.Context, question string, planContent string) (action string, feedback string, err error)
}

InputCollector provides interactive input collection for plan creation.

type Logger ¶

type Logger interface {
	SetPhase(phase Phase)
	Print(format string, args ...any)
	PrintRaw(format string, args ...any)
	PrintSection(section Section)
	PrintAligned(text string)
	LogQuestion(question string, options []string)
	LogAnswer(answer string)
	LogDraftReview(action string, feedback string)
	Path() string
}

Logger provides logging functionality.

type Mode ¶

type Mode string

Mode represents the execution mode.

const (
	ModeFull      Mode = "full"       // full execution: tasks + reviews + codex
	ModeReview    Mode = "review"     // skip tasks, run full review pipeline
	ModeCodexOnly Mode = "codex-only" // skip tasks and first review, run only codex loop
	ModeTasksOnly Mode = "tasks-only" // run only task phase, skip all reviews
	ModePlan      Mode = "plan"       // interactive plan creation mode
)

type Phase ¶ added in v0.4.0

type Phase string

Phase represents execution phase for color coding.

const (
	PhaseTask       Phase = "task"        // execution phase (green)
	PhaseReview     Phase = "review"      // code review phase (cyan)
	PhaseCodex      Phase = "codex"       // codex analysis phase (magenta)
	PhaseClaudeEval Phase = "claude-eval" // claude evaluating codex (bright cyan)
	PhasePlan       Phase = "plan"        // plan creation phase (info color)
	PhaseFinalize   Phase = "finalize"    // finalize step phase (green)
)

type QuestionPayload ¶ added in v0.4.0

type QuestionPayload struct {
	Question string   `json:"question"`
	Options  []string `json:"options"`
	Context  string   `json:"context,omitempty"`
}

QuestionPayload represents a question signal from Claude during plan creation

func ParseQuestionPayload(output string) (*QuestionPayload, error)

type Runner ¶

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

Runner orchestrates the execution loop.

func New(cfg Config, log Logger) *Runner

func NewWithExecutors(cfg Config, log Logger, claude, codex Executor, custom *executor.CustomExecutor) *Runner

func (r *Runner) Run(ctx context.Context) error

func (r *Runner) SetInputCollector(c InputCollector)

type Section ¶ added in v0.4.0

type Section struct {
	Type      SectionType
	Iteration int    // 0 for non-iterated sections
	Label     string // human-readable display text
}

Section carries structured information about a section header. instead of parsing section names with regex, consumers can access the Type and Iteration fields directly.

use the provided constructors (NewTaskIterationSection, etc.) to create sections with proper Type/Iteration/Label consistency.

func NewClaudeEvalSection() Section

func NewClaudeReviewSection(iteration int, suffix string) Section

func NewCodexIterationSection(iteration int) Section

func NewCustomIterationSection(iteration int) Section

func NewGenericSection(label string) Section

func NewPlanIterationSection(iteration int) Section

func NewTaskIterationSection(iteration int) Section

type SectionType ¶ added in v0.4.0

type SectionType int

SectionType represents the semantic type of a section header. the web layer uses these types to emit appropriate boundary events:

• SectionTaskIteration: emits task_start/task_end events
• SectionClaudeReview, SectionCodexIteration: emits iteration_start events
• SectionGeneric, SectionClaudeEval: no boundary events, just section headers

invariants:

• Iteration > 0 for SectionTaskIteration, SectionClaudeReview, SectionCodexIteration
• Iteration == 0 for SectionGeneric, SectionClaudeEval

prefer using the constructor functions (NewTaskIterationSection, etc.) to ensure these invariants are maintained.

const (
	// SectionGeneric is a static section header with no iteration.
	SectionGeneric SectionType = iota
	// SectionTaskIteration represents a task execution iteration.
	SectionTaskIteration
	// SectionClaudeReview represents a Claude review iteration.
	SectionClaudeReview
	// SectionCodexIteration represents a Codex review iteration.
	SectionCodexIteration
	// SectionClaudeEval represents Claude evaluating codex findings.
	SectionClaudeEval
	// SectionPlanIteration represents a plan creation iteration.
	SectionPlanIteration
	// SectionCustomIteration represents a custom review tool iteration.
	SectionCustomIteration
)