feat(ir): add typed helper for ArchiveFiles@2

[github-actions]

Summary

Adds archive_files_step to src/compile/ir/tasks.rs — a typed factory function for ArchiveFiles@2 that packages a folder or file into a zip, tar, 7z, or wim archive.

Motivation

Previously, any code that needed to emit an ArchiveFiles@2 step had to hand-craft TaskStep::new("ArchiveFiles@2", ...) with raw string inputs. This PR introduces a well-typed helper that makes required inputs explicit at the call site and documents all optional inputs.

Changes

• src/compile/ir/tasks.rs: archive_files_step(root_folder_or_file, archive_file) factory function with full doc comment covering all optional inputs
• 4 new unit tests covering:
  • required inputs (rootFolderOrFile, archiveFile)
  • archiveType override to tar with tarCompression
  • optional boolean flags (includeRootFolder, replaceExistingArchive)
  • 7z archive type with sevenZipCompression level

ADO Task Reference

• Task: ArchiveFiles@2
• Docs: (https://learn.microsoft.com/en-us/azure/devops/pipelines/tasks/reference/archive-files-v2)
• Required inputs: rootFolderOrFile (default: $(Build.BinariesDirectory)), archiveFile (default: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip)
• Optional inputs: archiveType (zip/7z/tar/wim, default zip), includeRootFolder, replaceExistingArchive, sevenZipCompression, tarCompression, verbose, quiet

Design

The archiveType input is optional via .with_input(...) rather than a positional parameter because zip covers the large majority of use cases. Callers that need tar or 7z add one .with_input("archiveType", "tar") call.

Validation

• cargo build --all-targets
• cargo test — 1999+ tests pass, 0 failures
• cargo clippy — pre-existing await_holding_lock warning in source_path_guard.rs (present on main before this PR, not introduced here)

---

Created by the ado-task-ir-contributor workflow.

Warning

Firewall blocked 2 domains

The following domains were blocked by the firewall during workflow execution:

• spsprodeus21.vssps.visualstudio.com
• spsprodweu4.vssps.visualstudio.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "spsprodeus21.vssps.visualstudio.com"
    - "spsprodweu4.vssps.visualstudio.com"

See Network Configuration for more information.

Generated by ADO Task IR Contributor · 710.7 AIC · ⌖ 34.4 AIC · ⊞ 36.1K · ◷