Bootstrap a monday.com Sprint Board from a Template as Code

id: monday-sprint-board-bootstrap
namespace: company.team
description: |
  Bootstrap a sprint board in monday.com as code. Create the board from a
  template, add Committed and Stretch groups, add a Status column, and
  post the new board id to Discord so the whole setup is one execution
  instead of fifteen minutes of Friday clicking.

inputs:
  - id: sprint_name
    type: STRING
    defaults: Sprint 42
    description: Name of the new sprint board as it will appear in monday.com.

  - id: template_id
    type: STRING
    defaults: "1234567890"
    description: monday.com template id to clone the board from. Replace with a real
      template id, or remove the templateId property on create_board to start
      from a blank board.

  - id: workspace_id
    type: STRING
    defaults: "1234567"
    description: Workspace id where the board is created. Copy it from the workspace URL.

tasks:
  - id: create_board
    type: io.kestra.plugin.monday.boards.Create
    description: Create the sprint board from the template inside the target
      workspace, emitting the new board id for every task that follows.
    apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
    boardName: "{{ inputs.sprint_name }}"
    boardKind: PUBLIC
    workspaceId: "{{ inputs.workspace_id }}"
    templateId: "{{ inputs.template_id }}"
    boardDescription: "Sprint board created by Kestra flow {{ flow.id }}, execution
      {{ execution.id }}."

  - id: committed_group
    type: io.kestra.plugin.monday.groups.Create
    description: Add the Committed group where the team places work it commits to
      finishing this sprint.
    apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
    boardId: "{{ outputs.create_board.boardId }}"
    groupName: Committed

  - id: stretch_group
    type: io.kestra.plugin.monday.groups.Create
    description: Add the Stretch group for work the team pulls in only if the
      committed scope lands early.
    apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
    boardId: "{{ outputs.create_board.boardId }}"
    groupName: Stretch

  - id: status_column
    type: io.kestra.plugin.monday.columns.Create
    description: Add a Status column so every item on the fresh board carries
      workflow state from the first minute.
    apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
    boardId: "{{ outputs.create_board.boardId }}"
    title: Status
    columnType: status

  - id: announce
    type: io.kestra.plugin.discord.DiscordIncomingWebhook
    description: Share the new board id and the created structure with the team
      channel so everyone starts the sprint on the same board.
    url: "{{ secret('DISCORD_WEBHOOK_URL') }}"
    payload: |
      {
        "content": "Sprint board {{ inputs.sprint_name }} is ready in monday.com (board id {{ outputs.create_board.boardId }}). Groups Committed ({{ outputs.committed_group.groupId }}) and Stretch ({{ outputs.stretch_group.groupId }}) plus a Status column ({{ outputs.status_column.columnId }}) were created by execution {{ execution.id }}."
      }

errors:
  - id: alert_failure
    type: io.kestra.plugin.discord.DiscordIncomingWebhook
    description: Alert Discord when the bootstrap fails so the team never starts a
      sprint on a half-built board.
    url: "{{ secret('DISCORD_WEBHOOK_URL') }}"
    payload: |
      {
        "content": "Sprint board bootstrap FAILED in flow {{ flow.id }} (execution {{ execution.id }}). The board may be partially created; check the task logs before retrying."
      }