Skip to main content

Module task

Module task 

Source
Expand description

One issue read as an executable development task.

Four groups, one per owner of the facts in it — see the module documentation for the table — and every field of every group attested. Nothing is read here: DevTaskModel carries the already-derived plan, the already-parsed record, the already-derived git trace and the already-resolved session records, and DevTask::build is a pure function of them. That is what lets the whole model be unit-tested without a repository and what keeps the derivations single: this file composes, it does not compute.

Structs§

DevTask
One issue as an executable development task: what was authored, where it sits, what has happened to it, where its external projection stands, and whether a worker may start it.
DevTaskDeclaration
What a person authored in the canonical record. Every field is FieldProvenance::Explicit or FieldProvenance::Unknown and nothing else: a value here was written down, or it does not exist.
DevTaskDiagnostic
One thing wrong with this task’s records, in the shape project.finding-carries-reproduce asks for.
DevTaskExecution
Local execution state: what actually happened in this checkout’s git history and session records. Derived where the relation was declared, inferred where it was not, and the fields say which.
DevTaskModel
Everything DevTask::build needs, gathered by the caller that has a repository.
DevTaskPosition
Where the task sits in the plan graph. Every field is derived; nothing here is authored, and nothing here is stored anywhere.
DevTaskSynchronisation
The external projection. Nothing here is ever written by this executable, and the fields that only the adapter can answer say so rather than reading as empty.
ReadinessVerdict
The readiness verdict, with everything it was derived from beside it.
RecordRef
The canonical record: where it is, and what it says.
SessionRef
One session record that names this issue, and how strongly.

Constants§

PROJECTION_ADAPTER
The adapter that owns the projection of this model onto GitHub.
RECONCILE_WITH
The commands that answer the external half of a task’s state.