Enhance customALGoFiles feature

[OleWunschmann]

❔What, Why & How

New file removal feature:

• Added a new filesToRemove field to the customALGoFiles section in both the in-memory settings and the JSON schema, allowing users to specify files that should always be removed from the repository during updates, regardless of their presence in the template. (Actions/.Modules/ReadSettings.psm1, Actions/.Modules/settings.schema.json) [1] [2]

Update logic improvements:

• Refactored the logic in GetFilesToUpdate and related helper functions to merge filesToInclude, filesToExclude, and filesToRemove from both repository and template settings, propagate removals from upstream templates, and correctly resolve file paths for removal operations. (Actions/CheckForUpdates/CheckForUpdates.HelperFunctions.ps1) [1] [2] [3]

• Added the ResolveFilePathsInDestinationFolder function to accurately identify files for removal in the target repository, supporting per-project and destination-relative path resolution. (Actions/CheckForUpdates/CheckForUpdates.HelperFunctions.ps1)

Telemetry and settings handling:

• Enhanced telemetry to track usage of filesToInclude, filesToExclude, and filesToRemove for both repository and template settings, providing better insights into feature adoption. (Actions/CheckForUpdates/CheckForUpdates.HelperFunctions.ps1)

• Updated the call to ReadSettings to include the -trigger parameter, ensuring settings are read with the correct context. (Actions/CheckForUpdates/CheckForUpdates.ps1)

• Prepared for template settings merging by initializing $templateRepoSettings and adjusting template download logic. (Actions/CheckForUpdates/CheckForUpdates.ps1)

Related to discussion: #2227

✅ Checklist

• Add tests (E2E, unit tests)
• Update RELEASENOTES.md
• Update documentation (e.g. for new settings or scenarios)
• Add telemetry

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

This PR enhances the customALGoFiles behavior during “Update AL-Go System Files”, adding support for unconditional removals (filesToRemove) and improving custom-template behavior by merging template settings directly and resolving files from the original AL-Go template where applicable.

Changes:

• Add customALGoFiles.filesToRemove support end-to-end (schema, defaults, resolution logic, docs, and release notes).
• Update CheckForUpdates to read template repo settings via ReadSettings and merge template settings during file resolution.
• Expand automated coverage (unit + e2e) for include/exclude/remove resolution and custom-template propagation.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
e2eTests/scenarios/CustomTemplate/runtest.ps1	Extends e2e scenario to validate custom-template file include/exclude/remove propagation and workflow presence.
Tests/CheckForUpdates.Action.Test.ps1	Adds unit tests for destination-folder resolution and expanded GetFilesToUpdate behaviors (including filesToRemove).
Actions/CheckForUpdates/CheckForUpdates.ps1	Updates settings reading (incl. trigger) and wires template settings + filesToRemove into update/removal flow.
Actions/CheckForUpdates/CheckForUpdates.HelperFunctions.ps1	Implements ResolveFilePathsInDestinationFolder and extends GetFilesToUpdate to produce include/exclude/remove lists.
Actions/.Modules/settings.schema.json	Extends settings schema with customALGoFiles.filesToRemove and clarifying descriptions.
Actions/.Modules/ReadSettings.psm1	Adds default filesToRemove array under customALGoFiles.
Scenarios/settings.md	Documents customALGoFiles.filesToRemove in settings reference.
Scenarios/CustomizingALGoForGitHub.md	Adds conceptual docs + examples for original-template resolution and filesToRemove.
RELEASENOTES.md	Documents enhanced customALGoFiles behavior and new filesToRemove.