docs(site): add PublishPipelineArtifact@1, DownloadPipelineArtifact@2, DeleteFiles@1 to typed-helpers table

[github-actions]

Summary

• Three typed factory helpers shipped in recent PRs (feat(ir): add typed helper for DownloadPipelineArtifact@2 #1063, feat(ir): add typed helper for PublishPipelineArtifact@1 #1065, feat(ir): add typed helper for DeleteFiles@1 #1071) were absent from the site docs. Contributors looking up available helpers in ir.mdx would miss them and fall back to hand-crafted TaskStep::new() calls unnecessarily.

Changes

• site/src/content/docs/reference/ir.mdx
  • Updated tasks.rs module-layout bullet to list all 12 helpers (previously only 9 were named)
  • Added three rows to the Available helpers table:
    • publish_pipeline_artifact_step(target_path) → PublishPipelineArtifact@1
    • download_pipeline_artifact_step(target_path) → DownloadPipelineArtifact@2
    • delete_files_step(contents) → DeleteFiles@1
• site/src/content/docs/guides/extending.mdx
  • Updated the cross-reference sentence listing all covered ADO tasks to include the three new entries

Accuracy checks

• publish_pipeline_artifact_step signature verified against src/compile/ir/tasks.rs line 320; required param is targetPath (ADO macros OK, no wildcards)
• download_pipeline_artifact_step signature verified at line 356; required param is targetPath
• delete_files_step signature verified at line 379; required param is Contents (newline-separated globs)
• All three ADO task identifiers (PublishPipelineArtifact@1, DownloadPipelineArtifact@2, DeleteFiles@1) verified from TaskStep::new(...) calls in tasks.rs

Validation

• cd site && npm ci && npm run build — 36 pages built, all internal links valid

---

Created by the docs-writer workflow.

Generated by Docs Writer · 484.2 AIC · ⌖ 18.4 AIC · ⊞ 34.4K · ◷

[jamesadevine]

Closing: this documents a removed API. The free-function helpers (publish_pipeline_artifact_step() etc.) and the src/compile/ir/tasks.rs file referenced here no longer exist on main — typed task helpers were refactored into builder structs (e.g. PublishPipelineArtifact::new(..).into_step()) under src/compile/ir/tasks/ (one file per task). The entire site IR-helpers table (extending.mdx, ir.mdx) is already stale from that refactor, so extending it here adds more drift. Tracked by a full IR-docs refresh issue instead.