Add cache-primary-key and cache-matched-key outputs to actions/cache

[stuartleeks]

Add cache-primary-key and cache-matched-key outputs from actions/cache/restore action to actions/cache action

Description

The actions/cache/restore action provides cache-hit, cache-primary-key and cache-matched-key outputs, but the actions/cache only exposes cache-hit.

Motivation and Context

Currently, determining the cache key that was matched requires using restore/save separately. This PR enables using the primary/matched cache keys in subsequent steps using actions/cache.

How Has This Been Tested?

Updated test code in the repo. Also the PR branch from another repo

Screenshots (if appropriate):

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation (add or update README or docs)

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes.
• All new and existing tests passed.

[Copilot]

Pull Request Overview

This PR adds functionality to expose the new outputs "cache-primary-key" and "cache-matched-key" from the cache restore process via the actions/cache action.

• Updated stateProvider.ts to invoke a new helper function (stateToOutput) to set these outputs.
• Updated action.yml, test files, and documentation (README.md) to support and validate these new outputs.

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/stateProvider.ts	Refactored setState implementations to trigger output setting for new keys.
action.yml	Added definitions for the new outputs with appropriate descriptions.
tests/stateProvider.test.ts	Updated expected output calls to reflect the additional outputs.
tests/restoreImpl.test.ts	Updated output expectations in tests to include the new outputs.
tests/restore.test.ts	Updated tests to check for the new outputs in various cache restore scenarios.
README.md	Updated documentation to include descriptions of the new outputs.

[Copilot]

[nitpick] Consider adding a brief comment above the 'stateToOutput' function explaining its purpose and usage to aid future maintainability.

Suggested change

	]);
	]);
	/**
	* Maps a state key to an output key using `stateToOutputMap` and sets the corresponding output value.
	* This function ensures that state changes are reflected in the output for subsequent steps.
	*/

[leonnicolas]

Yes please, at the moment the README has examples that use the cache-primary-key output and they don't work.

EDIT: I missed that the examples were using actions/cache/restore which does output the cache-primary-key.