Enable users to create tasks from Slack

docs/docs/administration/settings/plugins/configuring-slack.mdx

@@ -190,6 +190,7 @@ You can override their values if you wish to do so. Included below are their des
 | `/dispatch-update-incident`                                                         | Opens a modal to update the incident.                                                                                       |
 | `/dispatch-notifications-group`                                                     | Opens a modal to edit the notifications group.                                                                              |
 | `/dispatch-update-participant`                                                      | Opens a modal to update participant metadata.                                                                               |
+| `/dispatch-create-task`                                                             | Opens a modal to create an incident task.                                                                                   |
 
 ### Contact Information Resolver Plugin
 

docs/docs/user-guide/incidents/commander.mdx

@@ -27,7 +27,7 @@ All Slack commands are listed below, or you may view _groups_ of commands relati
 - [`/dispatch-update-incident`](#%2Fdispatch-update-incident)
 - [`/dispatch-update-participant`](#%2Fdispatch-update-participant)
 - [`/dispatch-run-workflow`](#%2Fdispatch-list-workflow)
-
+- [`/dispatch-create-task`](#%2Fdispatch-create-task)
 ## People
 
 These commands help manage the people helping resolve the incident.
@@ -205,3 +205,13 @@ This command will run a pre-configured workflow and associate its artifacts with
 ![](/img/slack-conversation-run-workflow.png)
 
 </div>
+
+### /dispatch-create-task
+
+This command will create a task for the current incident.
+<div style={{textAlign: 'center'}}>
+
+{/* TODO(averyl): replace this image */}
+![](/img/slack-conversation-create-task.png)
+
+</div>

src/dispatch/database/revisions/tenant/versions/2024-09-23_32652e0360dd.py

@@ -0,0 +1,105 @@
+"""Adds dispatch-create-task slug to slack conversation plugin config.
+
+Revision ID: 32652e0360dd
+Revises: 1f4dc687945d
+Create Date: 2024-09-23 16:02:50.742796
+
+"""
+
+from alembic import op
+from pydantic import SecretStr, ValidationError
+from pydantic.json import pydantic_encoder
+
+from sqlalchemy import Column, Integer, ForeignKey, String
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import relationship, Session
+from sqlalchemy.ext.hybrid import hybrid_property
+from sqlalchemy_utils import StringEncryptedType
+from sqlalchemy_utils.types.encrypted.encrypted_type import AesEngine
+from dispatch.config import config, DISPATCH_ENCRYPTION_KEY
+
+
+# revision identifiers, used by Alembic.
+revision = "32652e0360dd"
+down_revision = "1f4dc687945d"
+branch_labels = None
+depends_on = None
+
+Base = declarative_base()
+
+
+def show_secrets_encoder(obj):
+    if isinstance(obj, SecretStr):
+        return obj.get_secret_value()
+    else:
+        return pydantic_encoder(obj)
+
+
+def migrate_config(instances, slug, config):
+    for instance in instances:
+        if slug == instance.plugin.slug:
+            instance.configuration = config
+
+
+class Plugin(Base):
+    __tablename__ = "plugin"
+    __table_args__ = {"schema": "dispatch_core"}
+    id = Column(Integer, primary_key=True)
+    slug = Column(String, unique=True)
+
+
+class PluginInstance(Base):
+    __tablename__ = "plugin_instance"
+    id = Column(Integer, primary_key=True)
+    _configuration = Column(
+        StringEncryptedType(key=str(DISPATCH_ENCRYPTION_KEY), engine=AesEngine, padding="pkcs5")
+    )
+    plugin_id = Column(Integer, ForeignKey(Plugin.id))
+    plugin = relationship(Plugin, backref="instances")
+
+    @hybrid_property
+    def configuration(self):
+        """Property that correctly returns a plugins configuration object."""
+        pass
+
+    @configuration.setter
+    def configuration(self, configuration):
+        """Property that correctly sets a plugins configuration object."""
+        if configuration:
+            self._configuration = configuration.json(encoder=show_secrets_encoder)
+
+
+def upgrade():
+    # ### commands auto generated by Alembic - please adjust! ###
+    from dispatch.plugins.dispatch_slack.config import SlackConversationConfiguration
+
+    bind = op.get_bind()
+    session = Session(bind=bind)
+
+    instances = session.query(PluginInstance).all()
+
+    # Slash commands
+    SLACK_COMMAND_CREATE_TASK_SLUG = config(
+        "SLACK_COMMAND_CREATE_TASK_SLUG", default="/dispatch-create-task"
+    )
+
+    try:
+        slack_conversation_config = SlackConversationConfiguration(
+            slack_command_create_task=SLACK_COMMAND_CREATE_TASK_SLUG,
+        )
+
+        migrate_config(instances, "slack-conversation", slack_conversation_config)
+
+    except ValidationError:
+        print(
+            "Skipping automatic migration of slack plugin credentials, if you are using the slack plugin manually migrate credentials."
+        )
+
+    session.commit()
+    # ### end Alembic commands ###
+
+
+def downgrade():
+    # ### commands auto generated by Alembic - please adjust! ###
+    pass
+    # ### end Alembic commands ###

src/dispatch/plugins/dispatch_slack/config.py

@@ -151,3 +151,8 @@ class SlackConversationConfiguration(SlackConfiguration):
         title="List Workflows Command String",
         description="Defines the string used to list all available workflows. Must match what is defined in Slack",
     )
+    slack_command_create_task: str = Field(
+        "/dispatch-create-task",
+        title="Create Task Command String",
+        description="Defines the string used to create a task. Must match what is defined in Slack.",
+    )

src/dispatch/plugins/dispatch_slack/incident/enums.py

@@ -76,6 +76,15 @@ class ReportExecutiveBlockIds(DispatchEnum):
     next_steps = "report-executive-next-steps"
 
 
+class CreateTaskBlockIds(DispatchEnum):
+    assignee_select = "create-task-assignee-select"
+    description = "create-task-description"
+
+
+class CreateTaskActionIds(DispatchEnum):
+    submit = "create-task-submit"
+
+
 class IncidentUpdateActions(DispatchEnum):
     submit = "incident-update-submit"
     project_select = "incident-update-project-select"