feat(actions): add working-directory

neilime · neilime · commit 87f1647e82d9 · 2026-02-17T14:58:56.000+01:00
Signed-off-by: Emilien Escalle &lt;emilien.escalle@escemi.com&gt;
diff --git a/README.md b/README.md
@@ -19,36 +19,37 @@ Opinionated GitHub Actions and reusable workflows for foundational continuous-in
 
 ### Workflow & repository automation
 
-- [Checkout](actions/checkout/README.md) — event-aware drop-in replacement for `actions/checkout` that supports issue comment triggers.
-- [Create and merge pull request](actions/create-and-merge-pull-request/README.md) — opens a pull request, rebases, and merges it with the GitHub Actions bot identity.
-- [Create or update comment](actions/create-or-update-comment/README.md) — adds or updates comments on issues and pull requests idempotently.
-- [Get GitHub Actions bot user](actions/get-github-actions-bot-user/README.md) — retrieves the profile information for the GitHub Actions bot.
-- [Get issue number](actions/get-issue-number/README.md) — extracts the relevant issue number from the current workflow context.
+- [Checkout](actions/checkout/README.md) - event-aware drop-in replacement for `actions/checkout` that supports issue comment triggers.
+- [Create and merge pull request](actions/create-and-merge-pull-request/README.md) - opens a pull request, rebases, and merges it with the GitHub Actions bot identity.
+- [Create or update comment](actions/create-or-update-comment/README.md) - adds or updates comments on issues and pull requests idempotently.
+- [Get GitHub Actions bot user](actions/get-github-actions-bot-user/README.md) - retrieves the profile information for the GitHub Actions bot.
+- [Get issue number](actions/get-issue-number/README.md) - extracts the relevant issue number from the current workflow context.
 
 ### Matrix & workflow data helpers
 
-- [Get matrix outputs](actions/get-matrix-outputs/README.md) — aggregates outputs across matrix jobs for downstream steps.
-- [Set matrix output](actions/set-matrix-output/README.md) — writes structured outputs that can be consumed by other matrix jobs.
-- [Local workflow actions](actions/local-workflow-actions/README.md) — loads reusable workflow actions from the current repository.
+- [Get matrix outputs](actions/get-matrix-outputs/README.md) - aggregates outputs across matrix jobs for downstream steps.
+- [Set matrix output](actions/set-matrix-output/README.md) - writes structured outputs that can be consumed by other matrix jobs.
+- [Local workflow actions](actions/local-workflow-actions/README.md) - loads reusable workflow actions from the current repository.
 
 ### Repository insights & utilities
 
-- [Parse CI reports](actions/parse-ci-reports/README.md) — parses CI reports (tests, linting, coverage) into GitHub summaries and Markdown for PR comments.
-- [Repository owner is organization](actions/repository-owner-is-organization/README.md) — checks whether the repository owner is an organization.
-- [Slugify](actions/slugify/README.md) — converts free-form strings into GitHub-friendly slugs.
+- [Parse CI reports](actions/parse-ci-reports/README.md) - parses CI reports (tests, linting, coverage) into GitHub summaries and Markdown for PR comments.
+- [Repository owner is organization](actions/repository-owner-is-organization/README.md) - checks whether the repository owner is an organization.
+- [Working directory](actions/resolve-working-directory/README.md) - resolves and validates a working directory path as an absolute path.
+- [Slugify](actions/slugify/README.md) - converts free-form strings into GitHub-friendly slugs.
 
 ## Reusable Workflows
 
 ### Community & issue hygiene
 
-- [Greetings](.github/workflows/greetings.md) — welcomes first-time issue reporters and pull request authors.
-- [Need fix to Issue](.github/workflows/need-fix-to-issue.md) — labels issues that require follow-up fixes.
-- [Stale](.github/workflows/stale.md) — automatically marks and closes stale issues and pull requests.
+- [Greetings](.github/workflows/greetings.md) - welcomes first-time issue reporters and pull request authors.
+- [Need fix to Issue](.github/workflows/need-fix-to-issue.md) - labels issues that require follow-up fixes.
+- [Stale](.github/workflows/stale.md) - automatically marks and closes stale issues and pull requests.
 
 ### Quality gates
 
-- [Linter](.github/workflows/linter.md) — runs Super Linter and shared formatting checks across the repository.
-- [Semantic pull request](.github/workflows/semantic-pull-request.md) — enforces semantic pull request titles before merging.
+- [Linter](.github/workflows/linter.md) - runs Super Linter and shared formatting checks across the repository.
+- [Semantic pull request](.github/workflows/semantic-pull-request.md) - enforces semantic pull request titles before merging.
 
 ## Contributing
 
@@ -67,10 +68,10 @@ actions/{action-name}/
 
 ### Development standards
 
-1. **Pinned dependencies** – reference external actions by commit SHA (for example `actions/checkout@08c6903c…`).
-2. **Composite-first** – encapsulate logic in composite actions and keep scripts minimal.
-3. **Early validation** – validate inputs up front using GitHub Script or shell guards and fail fast with helpful messages.
-4. **Consistent branding** – set `author: hoverkraft` and `branding.color: blue` with an appropriate icon in every `action.yml`.
+1. **Pinned dependencies** - reference external actions by commit SHA (for example `actions/checkout@08c6903c…`).
+2. **Composite-first** - encapsulate logic in composite actions and keep scripts minimal.
+3. **Early validation** - validate inputs up front using GitHub Script or shell guards and fail fast with helpful messages.
+4. **Consistent branding** - set `author: hoverkraft` and `branding.color: blue` with an appropriate icon in every `action.yml`.
 
 ## Development Workflow
 
diff --git a/actions/working-directory/README.md b/actions/working-directory/README.md
@@ -0,0 +1,53 @@
+<!-- header:start -->
+
+# GitHub Action: Resolve working directory
+
+<div align="center">
+  <img src="../../.github/logo.svg" width="60px" align="center" alt="Resolve working directory" />
+</div>
+
+---
+
+<!-- header:end -->
+
+## Overview
+
+Action to resolve and validate a working directory path.
+
+## Usage
+
+```yaml
+- id: resolve-working-directory
+  uses: hoverkraft-tech/ci-github-common/actions/resolve-working-directory@<sha>
+  with:
+    working-directory: .
+```
+
+## Inputs
+
+| **Input**               | **Description**                                         | **Required** | **Default** |
+| ----------------------- | ------------------------------------------------------- | ------------ | ----------- |
+| **`working-directory`** | Relative or absolute working directory path to resolve. | No           | `.`         |
+
+## Outputs
+
+| **Output**              | **Description**                               |
+| ----------------------- | --------------------------------------------- |
+| **`working-directory`** | The resolved absolute working directory path. |
+
+## Example
+
+```yaml
+jobs:
+  example:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - id: resolve-working-directory
+        uses: hoverkraft-tech/ci-github-common/actions/resolve-working-directory@<sha>
+        with:
+          working-directory: actions/parse-ci-reports
+
+      - name: Show resolved directory
+        run: echo "${{ steps.resolve-working-directory.outputs.working-directory }}"
+```
diff --git a/actions/working-directory/action.yml b/actions/working-directory/action.yml
@@ -0,0 +1,44 @@
+name: "working directory"
+description: "Action to resolve and validate a working directory path."
+author: hoverkraft
+branding:
+  icon: folder
+  color: blue
+
+inputs:
+  working-directory:
+    description: "Relative or absolute working directory path to resolve."
+    required: false
+    default: "."
+
+outputs:
+  working-directory:
+    description: "The resolved absolute working directory path."
+    value: ${{ steps.working-directory.outputs.working-directory }}
+
+runs:
+  using: "composite"
+  steps:
+    - id: working-directory
+      uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+      env:
+        WORKING_DIRECTORY_INPUT: ${{ inputs.working-directory }}
+      with:
+        script: |
+          const fs = require('node:fs');
+          const path = require('node:path');
+
+          let workingDirectory = process.env.WORKING_DIRECTORY_INPUT || '.';
+
+          if (!path.isAbsolute(workingDirectory)) {
+            workingDirectory = path.join(process.env.GITHUB_WORKSPACE, workingDirectory);
+          }
+
+          if (!fs.existsSync(workingDirectory)) {
+            core.setFailed(`The specified working directory does not exist: ${workingDirectory}`);
+            return;
+          }
+
+          workingDirectory = path.resolve(workingDirectory);
+          core.debug(`Running in working directory: ${workingDirectory}`);
+          core.setOutput('working-directory', workingDirectory);
