Review state for workspace-local agent drafts.
The state field is intentionally limited to stable states. Promote, apply, discard, and resolve are transitions, not stored states.
Summary
Functions
Marks draft work as ready for review, or clean when no drafts exist.
Records more draft edits while staying in draft mode.
Moves review or conflict work back to draft mode when an agent resumes.
Moves a clean workspace into draft mode.
Clears all draft and conflict metadata and returns to clean.
Returns the number of conflicting files.
Clears drafts or conflicts without applying them.
Discards one file from draft and conflict metadata.
Returns the number of changed draft files.
Marks the workspace as needing review, optionally recording an error.
Creates a clean review state.
Returns true when the review has unapplied drafts, conflicts, or a recorded error.
Marks an overlap detected during promote.
Marks a successful promote as clean.
Marks conflicts as resolved and promoted.
Sets changed files without changing the stable state.
Types
@type error() :: term()
@type state() :: :clean | :draft | :needs_review | :conflict
@type t() :: %MingaEditor.State.WorkspaceReview{ changed_files: [Minga.Project.FileRef.t()], conflict_files: [Minga.Project.FileRef.t()], in_progress?: boolean(), last_error: error() | nil, state: state() }
Functions
@spec agent_completed(t(), [Minga.Project.FileRef.t()]) :: {:ok, t()} | {:error, term()}
Marks draft work as ready for review, or clean when no drafts exist.
@spec agent_made_more_edits(t(), [Minga.Project.FileRef.t()]) :: {:ok, t()} | {:error, term()}
Records more draft edits while staying in draft mode.
Moves review or conflict work back to draft mode when an agent resumes.
@spec agent_started_editing(t(), [Minga.Project.FileRef.t()]) :: {:ok, t()} | {:error, term()}
Moves a clean workspace into draft mode.
Clears all draft and conflict metadata and returns to clean.
@spec conflict_count(t()) :: non_neg_integer()
Returns the number of conflicting files.
Clears drafts or conflicts without applying them.
@spec discard_file(t(), Minga.Project.FileRef.t()) :: t()
Discards one file from draft and conflict metadata.
@spec draft_count(t()) :: non_neg_integer()
Returns the number of changed draft files.
@spec mark_needs_review(t(), [Minga.Project.FileRef.t()], error() | nil) :: t()
Marks the workspace as needing review, optionally recording an error.
@spec new() :: t()
Creates a clean review state.
Returns true when the review has unapplied drafts, conflicts, or a recorded error.
@spec promote_found_overlaps(t(), [Minga.Project.FileRef.t()], term()) :: {:ok, t()} | {:error, term()}
Marks an overlap detected during promote.
Marks a successful promote as clean.
Marks conflicts as resolved and promoted.
@spec set_changed_files(t(), [Minga.Project.FileRef.t()]) :: t()
Sets changed files without changing the stable state.