index.js

const core = require("@actions/core");
const { context, getOctokit } = require("@actions/github");
const util = require("node:util");
const { WebClient, LogLevel } = require("@slack/web-api");

const GOOD_COLOR = "#1a7f37";
const WARNING_COLOR = "#f2c744";
const DANGER_COLOR = "#cf222e";

const CLOCK_EMOJIS = Array.from({ length: 12 }, (_, key) => [
  `:clock${key + 1}:`,
  `:clock${key + 1}30:`,
]).flat();

process.on("unhandledRejection", handleError);
main().catch(handleError);

function secondsToClockEmoji(seconds) {
  return CLOCK_EMOJIS[Math.floor(seconds / 10) % CLOCK_EMOJIS.length];
}

function sleep(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

function durationToString(seconds) {
  seconds = Math.round(seconds);
  const hours = Math.floor(seconds / 3600);
  seconds -= hours * 3600;
  const minutes = Math.floor(seconds / 60);
  seconds -= minutes * 60;

  if (hours > 0) {
    return `${hours}h${minutes}m${seconds}s`;
  } else if (minutes > 0) {
    return `${minutes}m${seconds}s`;
  } else {
    if (seconds < 1) {
      seconds = 1;
    }
    return `${seconds}s`;
  }
}

function stepDuration(step) {
  let startedAt = new Date(step.started_at);
  let completedAt = new Date(step.completed_at || Date.now());

  if (completedAt.getTime() == 0) {
    completedAt = new Date();
  }

  return durationToString((completedAt - startedAt) / 1000);
}

function formatMessage({ description, active, completed, logUrl }) {
  const blocks = [];

  blocks.push({
    type: "section",
    text: {
      type: "mrkdwn",
      text: description,
    },
    accessory: {
      type: "button",
      text: {
        type: "plain_text",
        text: ":mag: Logs",
        emoji: true,
      },
      value: "click_logs",
      url: logUrl,
      action_id: "button-action",
    },
  });

  if (active.length > 0) {
    blocks.push({
      type: "context",
      elements: [
        {
          type: "mrkdwn",
          text: active.join("\n"),
        },
      ],
    });
  }

  if (completed.length > 0) {
    blocks.push({
      type: "context",
      elements: [
        {
          type: "mrkdwn",
          text: completed.join("\n"),
        },
      ],
    });
  }

  return blocks;
}

function titleCase(str) {
  return str.charAt(0).toUpperCase() + str.slice(1);
}

function conjugatePastTense(verb) {
  // Simple past tense rules for English - not perfect but handles common cases
  if (verb.endsWith('e')) {
    return verb + 'd';
  } else if (verb.endsWith('y') && !verb.endsWith('oy')) {  // Don't change 'oy' endings
    return verb.slice(0, -1) + 'ied';
  } else {
    return verb + 'ed';
  }
}

function getVerbForms(baseVerb) {
  // Convert to lowercase for consistency
  baseVerb = baseVerb.toLowerCase();

  // Get continuous form (present participle)
  let continuous;
  if (baseVerb.endsWith('e')) {
    continuous = baseVerb.slice(0, -1) + 'ing';
  } else {
    continuous = baseVerb + 'ing';
  }

  return {
    base: baseVerb,           // deploy
    continuous: continuous,    // deploying
    past: conjugatePastTense(baseVerb)  // deployed
  };
}

async function monitor({
  messageTs,
  importantSteps,
  github,
  logJobName,
  deployDescription,
  stepIdentifier,
  slack,
  slackChannel,
  longJobDuration,
  republishLongJobs,
  verbForms,
}) {
  let message, jobStartAt, importantJobStartAt;
  let description, logUrl;
  let active = [];
  let completed = [];
  let maxTimePending = 0;

  const sendMessage = async ({ color, republish }) => {
    if (republish && messageTs) {
      await slack.chat.delete({ channel: slackChannel, ts: messageTs });
      messageTs = null;
    }

    let blocks = formatMessage({ description, active, completed, logUrl });

    if (messageTs) {
      await slack.chat.update({
        ts: messageTs,
        channel: slackChannel,
        attachments: [{ color, fallback: message, blocks }],
      });
    } else {
      let response = await slack.chat.postMessage({
        channel: slackChannel,
        attachments: [{ color, fallback: message, blocks }],
      });
      core.debug(`response = ${util.inspect(response, { depth: 8 })}`);
      messageTs = response.ts;
      slackChannel = response.channel;
    }
  };

  const updateDescription = (completed, success) => {
    let emoji = "⏳";
    let prefix = titleCase(verbForms.continuous);
    if (completed) {
      emoji = success ? ":white_check_mark:" : ":x:";
      prefix = success ?
        titleCase(verbForms.past) :
        `Failed to ${verbForms.base}`;
      durationPrefix = success ? "in" : "after";
    }

    description = `${emoji} ${prefix} ${deployDescription}`;
    if (completed && importantJobStartAt) {
      description += ` ${durationPrefix} ${durationToString(
        (Date.now() - importantJobStartAt) / 1000
      )}`;
      if (maxTimePending > 10) {
        description += ` (queued ${durationToString(maxTimePending)})`;
      }
    }
  };

  const reportFailure = (reason) => {
    updateDescription(true, false);
    active = [];
    completed.push(reason);
    sendMessage({ color: DANGER_COLOR });
  };

  let running = true;
  process.on("SIGINT", () => {
    running = false;
    reportFailure("⚠️ Deploy was cancelled");
  });

  let statusStartedAt = new Date();
  const elapsed = () => (Date.now() - statusStartedAt) / 1000;

  try {
    while (running) {
      const {
        data: { jobs },
      } = await github.rest.actions.listJobsForWorkflowRunAttempt({
        ...context.repo,
        run_id: context.runId,
        attempt_number: process.env.GITHUB_RUN_ATTEMPT,
      });

      if (process.env.SLACK_ACTION_STATUS_DEBUG == "true") {
        console.log(util.inspect(jobs, { depth: 8 }));
      }

      // Use this special identifier to find the job that is running this action
      const statusJob = jobs.find((job) =>
        job.steps.find((step) => step.name.includes(stepIdentifier))
      );

      if (!statusJob) {
        console.log("Couldn't find status job. Trying again in 2 seconds.");
        console.log("jobs = " + util.inspect(jobs, { depth: 8 }));

        // If we couldn't
        if (elapsed() < 60) {
          await sleep(2000);
          continue;
        }

        throw new Error(
          `Could not find job with step identifier ${stepIdentifier}`
        );
      }

      if (!running) {
        break;
      }

      const importantJobs = jobs.filter((job) => job.id != statusJob.id);
      // Nothing to do
      if (importantJobs.length == 0) {
        break;
      }

      const pendingJobs = importantJobs.filter(
        (job) => job.status == "pending"
      );

      const inProgressJobs = importantJobs.filter(
        (job) => job.status == "in_progress"
      );

      const failedJobs = importantJobs.filter(
        (job) => job.conclusion == "failure"
      );

      logUrl = (
        importantJobs.find(
          (j) => logJobName != "" && j.name.includes(logJobName)
        ) ||
        inProgressJobs[0] ||
        failedJobs[0] ||
        importantJobs[0]
      ).html_url;
      jobStartAt = Math.min(...jobs.map((job) => new Date(job.started_at)));
      importantJobStartAt = Math.min(
        ...importantJobs.map((job) => new Date(job.started_at))
      );
      active = [];
      completed = [];

      for (const job of importantJobs) {
        for (const step of job.steps) {
          const emoji =
            process.env[
              `STATUS_${step.name.replace(/ /g, "_").toUpperCase()}_EMOJI`
            ] || ":hammer_and_wrench:";

          if (step.status == "completed") {
            if (step.conclusion == "success") {
              // Don't include successful steps that aren't important
              if (!importantSteps.includes(step.name)) {
                continue;
              }

              completed.push(
                `${emoji} ${step.name} completed in ${stepDuration(step)}`
              );
            } else if (step.conclusion == "skipped") {
              // all good
            } else {
              completed.push(`${step.name} failed after ${stepDuration(step)}`);
            }
          } else if (step.status == "in_progress") {
            active.push(
              `${emoji} ${step.name} running for ${stepDuration(step)}...`
            );
          }
        }
      }

      const jobsCompleted = !importantJobs.find(
        (job) => job.status != "completed"
      );
      const allSuccess = !importantJobs.find(
        (job) => job.conclusion != "success" && job.conclusion != "skipped"
      );
      const anyJobsStarted = importantJobs.find(
        (job) => job.status != "queued" && job.status != "pending"
      );

      let color;
      if (jobsCompleted) {
        if (allSuccess) {
          color = GOOD_COLOR; // "good" doesn't work
        } else {
          color = DANGER_COLOR; // "danger" doesn't work
        }

        // Clear active steps if the job is completed to mitigate
        // issues with the GitHub API returning stale data
        if (active.length > 0) {
          console.log(
            "importantJobs = " + util.inspect(importantJobs, { depth: 8 })
          );
          active = [];
        }
      } else if (pendingJobs.length > 0) {
        for (const job of pendingJobs) {
          const duration = (Date.now() - new Date(job.started_at)) / 1000;
          if (duration > maxTimePending) {
            maxTimePending = duration;
          }
          active.push(
            `${secondsToClockEmoji(duration)} ${
              job.name
            } queued for ${durationToString(duration)}...`
          );
        }
      } else if (anyJobsStarted) {
        color = WARNING_COLOR; // "warning" doesn't work
      }

      updateDescription(jobsCompleted, allSuccess);

      message = `${description}\n`;
      if (active.length > 0) {
        message += active.join("\n") + "\n";
      }
      if (completed.length > 0) {
        message += completed.join("\n") + "\n";
      }

      console.log("----------\n" + message);

      // If the job is completed and it has been running for a long time, optionally delete the message so it is reposted as a new message
      let republish =
        republishLongJobs && jobsCompleted && (Date.now() - jobStartAt) / 1000 > longJobDuration;
      sendMessage({ color, republish });

      if (jobsCompleted) {
        break;
      }

      await sleep(10000);
    }
  } catch (error) {
    reportFailure(":warning: Status reporter failed: " + error.message);
    throw error;
  }
}

async function main() {
  const token = core.getInput("github-token", { required: true });
  const debug = core.getInput("debug");
  const stepIdentifier = core.getInput("step-identifier", { required: true });
  const deployDescription =
    core.getInput("deploy-description") ||
      `${context.repository.repo} from \`${
        context.ref_name
      }\` (${context.sha.substring(0, 7)})`;
  const importantSteps = core
    .getInput("important-steps")
    .split(",")
    .map((s) => s.trim());
  const botToken = core.getInput("slack-bot-token", { required: true });
  const slackChannel = core.getInput("slack-channel-id", { required: true });
  const logJobName = core.getInput("log-job-name");
  const longJobDuration = core.getInput("long-job-duration");
  const republishLongJobs = core.getInput("republish-long-jobs") !== "false";
  const messageTs = core.getInput("slack-message-ts");

  // Get the base verb and derive its forms
  const baseVerb = core.getInput("verb") || "deploy";
  const verbForms = getVerbForms(baseVerb);

  // Allow override of past tense if needed
  if (core.getInput("verb-past")) {
    verbForms.past = core.getInput("verb-past");
  }

  const opts = {};
  if (debug === "true") {
    opts.log = console;
  }

  core.debug("context = " + util.inspect(context));

  const github = getOctokit(token, opts);
  const slack = new WebClient(botToken, { logLevel: LogLevel.ERROR });

  await monitor({
    messageTs,
    importantSteps,
    github,
    deployDescription,
    logJobName,
    stepIdentifier,
    slack,
    slackChannel,
    longJobDuration,
    republishLongJobs,
    verbForms,
  });
}

function handleError(err) {
  console.error(err);
  core.setFailed(`Unhandled error: ${err}`);
}