apify-test-tools 0.9.1-beta.8 → 0.10.0

package/.github/actions/checkout-restore-dependencies/action.yaml

@@ -1,13 +1,6 @@
 name: Checkout and restore dependencies
 description: Checkout and restore dependencies
 inputs:
-    working-directory:
-        description: Working directory
-        required: false
-        default: .
-    additional-working-directory:
-        description: Additional working directory
-        required: false
     npm-token:
         description: >-
             Token for installing private npm packages. Exported as both NPM_TOKEN (what a
@@ -26,7 +19,7 @@ outputs:
 
 # Sets common steps and ensure we use cached node_modules
 # To test a change here, repoint the `uses:` refs in the reusable workflows at your branch, and
-# change them back before merging. Merging to master no longer ships it: consumers track the `v0`
+# change them back before merging. Merging to master no longer ships it: consumers track the `workflows-v0`
 # tag, which only moves once the package version in .github/workflows-package-version is on npm.
 runs:
     using: 'composite'
@@ -60,30 +53,12 @@ runs:
           id: check-dependencies-cache
           uses: actions/cache@v5
           with:
-              path: ${{ inputs.working-directory }}/node_modules
-              key: modules-npm-${{ inputs.working-directory }}-${{ hashFiles(format('{0}/package-lock.json', inputs.working-directory)) }}
-
-        - name: Cache additional dependencies npm
-          id: check-additional-dependencies-cache
-          if: inputs.additional-working-directory != ''
-          uses: actions/cache@v5
-          with:
-              path: ${{ inputs.additional-working-directory }}/node_modules
-              key: modules-npm-${{ inputs.additional-working-directory }}-${{ hashFiles(format('{0}/package-lock.json', inputs.additional-working-directory)) }}
+              path: node_modules
+              key: modules-npm-${{ hashFiles('package-lock.json') }}
 
         - name: install npm dependencies
           if: steps.check-dependencies-cache.outputs.cache-hit != 'true'
           shell: bash
-          working-directory: ${{ inputs.working-directory }}
-          env:
-              NPM_TOKEN: ${{ inputs.npm-token }}
-              NODE_AUTH_TOKEN: ${{ inputs.npm-token }}
-          run: npm ci
-
-        - name: install additional npm dependencies
-          if: inputs.additional-working-directory != '' && steps.check-additional-dependencies-cache.outputs.cache-hit != 'true'
-          shell: bash
-          working-directory: ${{ inputs.additional-working-directory }}
           env:
               NPM_TOKEN: ${{ inputs.npm-token }}
               NODE_AUTH_TOKEN: ${{ inputs.npm-token }}
@@ -96,7 +71,6 @@ runs:
           # Needs the npm token too: a repo whose .npmrc routes all traffic through a private
           # registry has to authenticate even for public packages.
           shell: bash
-          working-directory: ${{ inputs.working-directory }}
           env:
               NPM_TOKEN: ${{ inputs.npm-token }}
               NODE_AUTH_TOKEN: ${{ inputs.npm-token }}

package/.github/scripts/check-major-tag-refs.mjs

@@ -36,7 +36,7 @@ const walk = (rel) => {
 
 const problems = [];
 
-// Self-references, e.g. `uses: apify/apify-test-tools/.github/workflows/public_pr-build-test.yaml@v0`.
+// Self-references, e.g. `uses: apify/apify-test-tools/.github/workflows/public_pr-build-test.yaml@workflows-v0`.
 // The ref charset stops at a backtick or quote so a ref quoted in prose isn't captured with its
 // punctuation; git refnames cannot end in a dot, so a sentence-final one is trimmed.
 const SELF_REF = /apify\/apify-test-tools\/\.github\/\S*?@([A-Za-z0-9._/-]+)/g;

package/.github/workflows/_move_major_tag.yaml

@@ -32,16 +32,24 @@ jobs:
             contents: write
         env:
             # The major version consumers pin, e.g.
-            # `uses: apify/apify-test-tools/.github/workflows/public_pr-build-test.yaml@v0`.
+            # `uses: apify/apify-test-tools/.github/workflows/public_pr-build-test.yaml@workflows-v0`.
             # Bump this only for a breaking change to a workflow's inputs, secrets or behaviour.
             # The previous tag then stops moving and keeps working, so repos migrate when they get
             # to it instead of all at once.
             #
             # This tracks the workflows' own contract, not the npm package version — the two move
-            # independently by design, so `v0` here is expected to outlive the package reaching 1.0.
+            # independently by design, so this is expected to outlive the package reaching 1.0.
+            #
+            # Deliberately not a bare `v0`. The package releases as `v0.9.0`, `v0.8.6` and so on, and
+            # a bare major tag sits in that same namespace: git-cliff hard-errors on it
+            # ("unexpected character 'v' while parsing major version number") and only skips it
+            # because apify/actions ships `tag_pattern = "v[0-9]+\\."`, whose trailing dot excludes
+            # it. Depending on a regex in another repo to keep releases working is not a dependency
+            # worth having, and `v1` beside a package `v1.0.0` would be worse still.
+            #
             # `uses:` cannot take an expression, so every ref into this repo hardcodes this same tag;
             # check-major-tag-refs.mjs fails the build if one of them drifts.
-            MAJOR_TAG: v0
+            MAJOR_TAG: workflows-v0
         steps:
             - name: Checkout repository
               uses: actions/checkout@v6

package/.github/workflows/public_platform-tests-claude-investigate-and-fix.yaml

@@ -20,7 +20,7 @@ name: 'Platform tests: Claude failure investigation and fix'
 #
 # jobs:
 #     platformTestsCore:
-#         uses: apify/apify-test-tools/.github/workflows/public_platform-tests.yaml@v0
+#         uses: apify/apify-test-tools/.github/workflows/public_platform-tests.yaml@workflows-v0
 #         with:
 #             subtest: core
 #         secrets: inherit
@@ -28,7 +28,7 @@ name: 'Platform tests: Claude failure investigation and fix'
 #     handle-failure:
 #         needs: platformTestsCore
 #         if: ${{ failure() }}
-#         uses: apify/apify-test-tools/.github/workflows/public_platform-tests-claude-investigate-and-fix.yaml@v0
+#         uses: apify/apify-test-tools/.github/workflows/public_platform-tests-claude-investigate-and-fix.yaml@workflows-v0
 #         secrets: inherit
 
 on:

package/.github/workflows/public_platform-tests.yaml

@@ -13,13 +13,6 @@ on:
                 type: string
                 default: ''
                 required: false
-            working-directory:
-                type: string
-                default: .
-                required: false
-            additional-working-directory:
-                type: string
-                required: false
             # Defaults to #notif-<repo-name> when empty, matching the previous behavior.
             report-slack-channel:
                 type: string
@@ -31,16 +24,11 @@ jobs:
         name: Scheduled Platform tests
         if: github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main'
         runs-on: ubuntu-latest
-        defaults:
-            run:
-                working-directory: ${{ inputs.working-directory }}
         steps:
             - name: Setup repository and dependencies
               # For testing, you have to temporarily change the branch
-              uses: apify/apify-test-tools/.github/actions/checkout-restore-dependencies@v0
+              uses: apify/apify-test-tools/.github/actions/checkout-restore-dependencies@workflows-v0
               with:
-                  working-directory: ${{ inputs.working-directory }}
-                  additional-working-directory: ${{ inputs.additional-working-directory }}
                   npm-token: ${{ secrets.NPM_TOKEN }}
 
             - name: Test

package/.github/workflows/public_pr-build-test.yaml

@@ -3,13 +3,6 @@ name: Test
 on:
     workflow_call:
         inputs:
-            working-directory:
-                type: string
-                default: .
-                required: false
-            additional-working-directory:
-                type: string
-                required: false
             skip-platform-tests:
                 type: boolean
                 default: false
@@ -28,17 +21,12 @@ jobs:
     platformTest:
         if: ${{ !inputs.skip-platform-tests }}
         runs-on: ubuntu-latest
-        defaults:
-            run:
-                working-directory: ${{ inputs.working-directory }}
         steps:
             - name: Setup repository and dependencies
               id: setup
               # For testing, you have to temporarily change the branch
-              uses: apify/apify-test-tools/.github/actions/checkout-restore-dependencies@v0
+              uses: apify/apify-test-tools/.github/actions/checkout-restore-dependencies@workflows-v0
               with:
-                  working-directory: ${{ inputs.working-directory }}
-                  additional-working-directory: ${{ inputs.additional-working-directory }}
                   # Some repos use private npm packages, they need to pass NPM_TOKEN secret to this workflow
                   npm-token: ${{ secrets.NPM_TOKEN }}
 
@@ -87,13 +75,9 @@ jobs:
                   # environment variables rather than being interpolated into it.
                   HEAD_REF: ${{ github.head_ref }}
                   BASE_REF: ${{ github.base_ref }}
-                  WORKING_DIRECTORY: ${{ inputs.working-directory }}
               run: |
-                  work_dir="$WORKING_DIRECTORY"
-                  [ "$work_dir" = "." ] && work_dir=""
-                  prefix="${work_dir:+$work_dir/}test/platform/"
-                  changed=$(git diff --name-only --diff-filter=d "origin/$BASE_REF...HEAD" -- "$prefix" \
-                    | sed "s|^$prefix|./test/platform/|" | tr '\n' ' ')
+                  changed=$(git diff --name-only --diff-filter=d "origin/$BASE_REF...HEAD" -- test/platform/ \
+                    | sed "s|^|./|" | tr '\n' ' ')
                   branch_actors=$(npx apify-test-tools get-affected-actors \
                     --source-branch "origin/$HEAD_REF" \
                     --target-branch "origin/$BASE_REF")
@@ -135,17 +119,11 @@ jobs:
     unitTest:
         # TODO: only run on changes to code
         runs-on: ubuntu-latest
-        defaults:
-            run:
-                working-directory: ${{ inputs.working-directory }}
-
         steps:
             - name: Setup repository and dependencies
               # For testing, you have to temporarily change the branch
-              uses: apify/apify-test-tools/.github/actions/checkout-restore-dependencies@v0
+              uses: apify/apify-test-tools/.github/actions/checkout-restore-dependencies@workflows-v0
               with:
-                  working-directory: ${{ inputs.working-directory }}
-                  additional-working-directory: ${{ inputs.additional-working-directory }}
                   npm-token: ${{ secrets.NPM_TOKEN }}
 
             - name: TypeScript

package/.github/workflows/public_push-build-latest.yaml

@@ -3,13 +3,6 @@ name: Build latest and report to slack
 on:
     workflow_call:
         inputs:
-            working-directory:
-                type: string
-                default: .
-                required: false
-            additional-working-directory:
-                type: string
-                required: false
             # Defaults to #notif-<repo-name> when empty, matching the previous behavior.
             report-slack-channel:
                 type: string
@@ -24,20 +17,16 @@ jobs:
             !contains(github.event.head_commit.message, '[skip platform-test]')
 
         runs-on: ubuntu-latest
-        defaults:
-            run:
-                working-directory: ${{ inputs.working-directory }}
-
         steps:
             - name: Setup repository and dependencies
               id: setup
               # For testing, you have to temporarily change the branch
-              uses: apify/apify-test-tools/.github/actions/checkout-restore-dependencies@v0
+              uses: apify/apify-test-tools/.github/actions/checkout-restore-dependencies@workflows-v0
               with:
-                  working-directory: ${{ inputs.working-directory }}
-                  additional-working-directory: ${{ inputs.additional-working-directory }}
                   npm-token: ${{ secrets.NPM_TOKEN }}
 
+            # --base-commit is the last commit that is already released: the push's "before" commit.
+            # Everything after it up to HEAD gets released. See the "Releasing Actors" section of the README.
             # run-with-apify-tokens.mjs reads the token names from in apify-test-tools.config.json
             # and hands the build those secrets and nothing else, so the tokens stay in this one command instead of the whole job.
             # The library never sees secrets it doesn't need
@@ -47,7 +36,7 @@ jobs:
                   SLACK_TOKEN_RELEASES_BOT: ${{ secrets.SLACK_TOKEN_RELEASES_BOT }}
               run: |
                   node "${{ steps.setup.outputs.scripts-path }}/run-with-apify-tokens.mjs" \
-                    npx apify-test-tools release --push-event-path ${{ github.event_path }} --release-slack-channel "#delivery-public-actors" --report-slack-channel "${{ inputs.report-slack-channel || format('#notif-{0}', github.event.repository.name) }}" --use-docker-cache
+                    npx apify-test-tools release --base-commit ${{ github.event.before }} --release-slack-channel "#delivery-public-actors" --report-slack-channel "${{ inputs.report-slack-channel || format('#notif-{0}', github.event.repository.name) }}" --use-docker-cache
 
             - name: Delete old builds
               env:

package/.github/workflows/public_review.yaml

@@ -14,7 +14,7 @@ on:
                 description: Label added after a successful review and never removed. Set to an empty string to disable.
                 required: false
             prompt-ref:
-                default: v0
+                default: workflows-v0
                 type: string
                 description: >-
                     Ref of this repository to fetch the review instructions from. Defaults to the
@@ -26,13 +26,6 @@ on:
                 type: string
                 description: Model to use for Claude Code (best, sonnet, opus, haiku, sonnet[1m], opus[1m], opusplan)
                 required: false
-            working-directory:
-                type: string
-                default: .
-                required: false
-            additional-working-directory:
-                type: string
-                required: false
         secrets:
             ANTHROPIC_API_KEY:
                 required: true

package/.github/workflows-package-version

@@ -1 +1 @@
-0.9.0
+0.10.0

package/CHANGELOG.md

@@ -2,20 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
-<!-- git-cliff-unreleased-start -->
-## 0.9.1 - **not yet released**
+## [0.10.0](https://github.com/apify/apify-test-tools/releases/tag/v0.10.0) (2026-09-30)
 
 ### 🚀 Features
 
 - **config/modes:** Lay groundwork for multiple configuration structures ([#142](https://github.com/apify/apify-test-tools/pull/142)) ([7e18638](https://github.com/apify/apify-test-tools/commit/7e18638a8d3523154dbe819312c2b16b54c548ff)) by [@JuanGalilea](https://github.com/JuanGalilea)
 - **workflows:** Host the reusable GitHub workflows in this repo ([#120](https://github.com/apify/apify-test-tools/pull/120)) ([10f089d](https://github.com/apify/apify-test-tools/commit/10f089d85146ceb7cdae964cfa1fc2577df43a37)) by [@metalwarrior665](https://github.com/metalwarrior665)
+- **mode:** Add grouped config mode ([#143](https://github.com/apify/apify-test-tools/pull/143)) ([9d0b93e](https://github.com/apify/apify-test-tools/commit/9d0b93e194a2cd810a31bcef4ca9457fd9ebfb9b)) by [@JuanGalilea](https://github.com/JuanGalilea)
 
 ### 🐛 Bug Fixes
 
 - Apply default actor timeout to runs ([#134](https://github.com/apify/apify-test-tools/pull/134)) ([82f5f7d](https://github.com/apify/apify-test-tools/commit/82f5f7d4de990db7ad8edf940c19ffd6b20bad13)) by [@Patai5](https://github.com/Patai5)
+- Copy cli to zip to KV store local builds ([#151](https://github.com/apify/apify-test-tools/pull/151)) ([ecdda58](https://github.com/apify/apify-test-tools/commit/ecdda58b68a8c7173a023e3a92689bc4fa0ce53c)) by [@gytelio](https://github.com/gytelio), closes [#140](https://github.com/apify/apify-test-tools/issues/140)
+
+### 🚜 Refactor
+
+- **workflows:** [**breaking**] Rename the floating tag to workflows-v0 ([#146](https://github.com/apify/apify-test-tools/pull/146)) ([c48fb22](https://github.com/apify/apify-test-tools/commit/c48fb223c885c4e5de7e5f64d8c14f6d03fcc7de)) by [@metalwarrior665](https://github.com/metalwarrior665)
+- **bin:** [**breaking**] Remove GitHub event dependency from release command ([#153](https://github.com/apify/apify-test-tools/pull/153)) ([e6953aa](https://github.com/apify/apify-test-tools/commit/e6953aa095d1a92638c6d72441e1b312d9f835c3)) by [@metalwarrior665](https://github.com/metalwarrior665), closes [#131](https://github.com/apify/apify-test-tools/issues/131)
 
 
-<!-- git-cliff-unreleased-end -->
 ## [0.9.0](https://github.com/apify/apify-test-tools/releases/tag/v0.9.0) (2026-08-11)
 
 ### 🚀 Features

package/CONTRIBUTING.md

@@ -10,7 +10,6 @@ The package consists of three parts:
 
 - `bin/build.ts` actor building
 - `bin/git.ts` git wrappers for getting relevant git commits and changed files
-- `bin/github.ts` github push event parsing
 - `bin/main.ts` entrypoing
 - `bin/slack.ts` sending notifications to slack
 - `bin/test-report.ts` processing vitest's test reports
@@ -40,12 +39,11 @@ git clone git@github.com:apify-store/testing-repo-for-github-actions.git
 
 #### Working on the CLI
 
-To work on the library, you just need to define `GITHUB_WORKSPACE` to tell the cli where you repo is located:
+To work on the library, point the cli to your repo with `--workspace` (it defaults to the current directory):
 
 ```sh
-export GITHUB_WORKSPACE=../path/to/testing-repo-for-github-actions # path to the repo
 npx tsx bin/main.ts --help
-npx tsx bin/main.ts get-commits --target-branch master --source-branch feat/testing-feature-branch
+npx tsx bin/main.ts --workspace ../path/to/testing-repo-for-github-actions get-commits --target-branch master --source-branch feat/testing-feature-branch
 ```
 
 #### Working on the library
@@ -71,14 +69,20 @@ this repo's own triggers.
 A `public_` filename is part of the contract — it is baked into every consumer's `uses:` line, so
 renaming one is a breaking change that needs a major tag bump, not a tidy-up.
 
-Consumers pin `@v0`, not `@master`. See
+The tag is not semver, so `git-cliff` would abort on it. It is skipped only because
+`apify/actions`' cliff.toml sets `tag_pattern = "v[0-9]+\."` — a release failing with
+`Semver error: unexpected character` means that pattern changed, not that anything here is wrong.
+The action's "Nothing to release" guard resolves to this tag and no longer fires, so an empty stable
+release fails at `npm publish` instead of erroring cleanly.
+
+Consumers pin `@workflows-v0`, not `@master`. See
 [Versioning and releases](./README.md#versioning-and-releases) in the README for how the tag and the
 npm release relate — the short version:
 
 - changing only a workflow needs no npm release
 - changing only the package needs no workflow change
 - a workflow that calls a **new** CLI feature must set `.github/workflows-package-version` to the
-  version that will contain it, in the same PR. The `v0` tag is then held until that version is on
+  version that will contain it, in the same PR. The `workflows-v0` tag is then held until that version is on
   npm, so merging can't ship a workflow that calls a CLI that doesn't exist yet.
 
 `.github/workflows-package-version` holds one exact version, and the stable release writes it. The
@@ -99,5 +103,5 @@ pushing workflow changes.
 
 `public_review` is the odd one out: it fetches `.github/review-prompt.md` over HTTP at run time, because a
 reusable workflow runs with the caller's repo checked out and never gets its own. Its `prompt-ref`
-input defaults to `v0` so the instructions come from the same release as the workflow — leaving it
+input defaults to `workflows-v0` so the instructions come from the same release as the workflow — leaving it
 at `master` would run released workflows against unreleased instructions.