internal/server/server.go

@@ -1293,7 +1293,14 @@ func (s *Server) execCommand(w http.ResponseWriter, r *http.Request) {
 		}
 		decision, err := s.ProjectCommandPreflight(r.Context(), body.AnchorMessageID, "project-command:"+commandID)
 		if err != nil || decision.State != extension.ProjectWorkProceed || decision.DecisionID == "" {
-			http.Error(w, "project command source analysis is not complete", http.StatusConflict)
+			reason := decision.Reason
+			if err != nil {
+				reason = err.Error()
+			}
+			if reason == "" {
+				reason = "source analysis did not commit a proceed decision"
+			}
+			http.Error(w, "project command source analysis is not complete: "+reason, http.StatusConflict)
 			return
 		}
 	}