feat: add repository-elapsed-time action (#58)

Author: FidelusAleksander

actions/repository-elapsed-time/README.md

@@ -0,0 +1,29 @@
+# Repository Elapsed Time :package:
+
+A GitHub Action that checks the time since the repository was created and returns it in multiple formats.
+
+## Outputs 📤
+
+| Name             | Description                                                                                                         |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `minutes`        | Number of minutes since repository creation                                                                         |
+| `human-readable` | Human readable time since repository creation (e.g., "5 days and 12 hours", "3 hours and 45 minutes", "30 minutes") |
+
+## Usage 🚀
+
+```yaml
+steps:
+  - name: Check repository age
+    id: repo-age
+    uses: skills/exercise-toolkit/actions/repository-elapsed-time@<git-tag>
+
+  - name: Use the outputs
+    run: |
+      echo "Repository is ${{ steps.repo-age.outputs.human-readable }} old"
+      echo "Minutes: ${{ steps.repo-age.outputs.minutes }}"
+
+  - name: Run step if repository is older than 1 hour
+    if: steps.repo-age.outputs.minutes > 60
+    run: |
+      echo "This repository has been around for more than an hour!"
+```

actions/repository-elapsed-time/action.yml

@@ -0,0 +1,49 @@
+name: "Repository Elapsed Time"
+description: "Checks the time since the repository was created and returns it in multiple formats"
+outputs:
+  minutes:
+    description: "Number of minutes since repository creation"
+    value: ${{ steps.calculate-time.outputs.minutes }}
+  human-readable:
+    description: "Human readable time since repository creation"
+    value: ${{ steps.calculate-time.outputs.human-readable }}
+runs:
+  using: "composite"
+  steps:
+    - name: Calculate repository elapsed time
+      id: calculate-time
+      uses: actions/github-script@v7
+      with:
+        script: |
+          const { data: repo } = await github.rest.repos.get({
+            owner: context.repo.owner,
+            repo: context.repo.repo
+          });
+
+          const createdAt = new Date(repo.created_at);
+          const now = new Date();
+          const diffMs = now - createdAt;
+
+          // Calculate different time units
+          const minutes = Math.floor(diffMs / (1000 * 60));
+          const hours = Math.floor(diffMs / (1000 * 60 * 60));
+          const days = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+
+          // Create human readable format
+          let humanReadable;
+          if (days > 0) {
+            const remainingHours = hours % 24;
+            humanReadable = `${days} day${days > 1 ? 's' : ''} and ${remainingHours} hour${remainingHours !== 1 ? 's' : ''}`;
+          } else if (hours > 0) {
+            const remainingMinutes = minutes % 60;
+            humanReadable = `${hours} hour${hours > 1 ? 's' : ''} and ${remainingMinutes} minute${remainingMinutes !== 1 ? 's' : ''}`;
+          } else {
+            humanReadable = `${minutes} minutes`;
+          }
+
+          // Set outputs
+          core.setOutput('minutes', minutes.toString());
+          core.setOutput('human-readable', humanReadable);
+
+          console.log(`✅ Repository created: ${repo.created_at}`);
+          console.log(`✅ Elapsed time: ${humanReadable} (${minutes} minutes)`);