CLI: update cmdline deprecate decorator to include version

src/aiida/cmdline/utils/decorators.py

@@ -239,7 +239,7 @@ def do_circus_stuff():
     return wrapped(*args, **kwargs)
 
 
-def deprecated_command(message):
+def deprecated_command(message, version=None):
     """Function decorator that will mark a click command as deprecated when invoked.
 
     Example::
@@ -259,7 +259,10 @@ def wrapper(wrapped, _, args, kwargs):
 
         template = templates.env.get_template('deprecated.tpl')
         width = 80
-        echo.echo(template.render(msg=wrap(message, width - 4), width=width))
+        message_ = message
+        if version is not None:
+            message_ = f'{message_} (this will be removed in v{version})'
+        echo.echo(template.render(msg=wrap(message_, width - 4), width=width))
 
         return wrapped(*args, **kwargs)