huskies: merge 868

server/src/agents/lifecycle.rs

@@ -248,6 +248,28 @@ pub fn transition_to_blocked(story_id: &str, reason: &str) -> Result<(), String>
     .map_err(|e| e.to_string())
 }
 
+/// Transition a story from `Stage::Merge` to `Stage::MergeFailure` via the state machine.
+///
+/// Builds a `PipelineEvent::MergeFailed { reason }`, validates the transition, writes
+/// the resulting `Stage::MergeFailure` to the CRDT, and persists the reason to front
+/// matter so it survives server restarts.
+/// Returns `Err` on `TransitionError` — callers must NOT fall back to direct register writes.
+pub fn transition_to_merge_failure(story_id: &str, reason: &str) -> Result<(), String> {
+    let reason_owned = reason.to_string();
+    let transform: Box<dyn Fn(&str) -> String> = Box::new(move |content: &str| {
+        crate::io::story_metadata::write_merge_failure_in_content(content, &reason_owned)
+    });
+    apply_transition(
+        story_id,
+        PipelineEvent::MergeFailed {
+            reason: reason.to_string(),
+        },
+        Some(&*transform),
+    )
+    .map(|_| ())
+    .map_err(|e| e.to_string())
+}
+
 /// Transition a story out of `Blocked` back to `Coding` via the state machine.
 ///
 /// Builds a `PipelineEvent::Unblock`, validates the transition, writes the
@@ -301,6 +323,7 @@ fn map_stage_move_to_event(
         }),
         (Stage::Coding | Stage::Qa | Stage::Backlog, "done") => Ok(PipelineEvent::Close),
         (Stage::Blocked { .. }, "current") => Ok(PipelineEvent::Unblock),
+        (Stage::MergeFailure { .. }, "backlog") => Ok(PipelineEvent::Unblock),
         (
             Stage::Archived {
                 reason: ArchiveReason::Blocked { .. },
@@ -388,6 +411,7 @@ fn stage_to_name(s: &Stage) -> &'static str {
         Stage::Blocked { .. } => "blocked",
         Stage::Qa => "qa",
         Stage::Merge { .. } => "merge",
+        Stage::MergeFailure { .. } => "merge_failure",
         Stage::Done { .. } => "done",
         Stage::Archived { .. } => "archived",
         Stage::Frozen { .. } => "frozen",