Skip to main content

Module progress

Module progress 

Source
Expand description

Live progress: what a run is doing while it does it.

Events are a side channel — not journaled, not evidence — so replay and verdicts are untouched. Live keeps live.json in the project’s state directory up to date (read by speccoder report --live from another terminal), prices token counts when [model] has prices, and forwards each event to the CLI’s printer.

Structs§

CollectionFile
One judged file of Event::CollectionChecked.
Live
Keeps live.json, prices usage, forwards to a printer.
LiveAgent
An external agent’s attempt as it goes: its plan, and what speccoder decided of what it asked.
LiveState
What live.json holds.
PlanEntry
One entry of an external agent’s plan.
PlannedTask
One task of a feature run’s plan.
ShownReproduction
A reproduction as the stream shows it: never its content.
ShownSpecialCase
A special case as the stream shows it.
StatementClass
One statement’s class in a reproduce try.

Enums§

BugEvent
A bug’s step.
Event
Something a run did.
OracleEvent
A step of the oracle at review.
ProjectEvent
A new project’s step, its creation or its undo.

Constants§

FILE
The live file in a project’s state directory.
RECENT
Tool calls live.json keeps for watchers (speccoder tui).

Traits§

Progress
Receives events as they happen.

Functions§

alive
Whether process pid is alive.
read_live
The project’s live.json and whether its process is still alive.
stage_word
verify, attempt 1/2, or starting.
status
status_with in the default state directory.
status_with
speccoder report --live: the project’s current (or last) run, from live.json, in the state directory state.
tail
The last lines of command output worth showing: at most five non-empty lines, each at most 200 characters, control characters removed.
target
The target of a tool call, for one line.
usd
USD for token counts (input includes cache reads and writes).