feat: add promotion step to remove a file/directory

[nitishfy]

Fixes #2860

[netlify]

✅ Deploy Preview for docs-kargo-io ready!

Name	Link
🔨 Latest commit	df9127c
🔍 Latest deploy log	https://app.netlify.com/sites/docs-kargo-io/deploys/6764c3272515600008f3a5d0
😎 Deploy Preview	https://deploy-preview-3086.docs.kargo.io
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[codecov]

Codecov Report

Attention: Patch coverage is 53.65854% with 38 lines in your changes missing coverage. Please review.

Project coverage is 51.17%. Comparing base (404422a) to head (df9127c).
Report is 44 commits behind head on main.

Files with missing lines	Patch %	Lines
internal/directives/file_deleter.go	53.65%	30 Missing and 8 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3086      +/-   ##
==========================================
- Coverage   51.20%   51.17%   -0.04%     
==========================================
  Files         283      287       +4     
  Lines       25466    25994     +528     
==========================================
+ Hits        13041    13303     +262     
- Misses      11729    11980     +251     
- Partials      696      711      +15     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[krancour]

This needs docs.

[krancour]

@nitishfy we're looking to have 1.2 work done by 12/20 with plans to release after the winter break. Are you able to implement feedback before then?

[nitishfy]

cc @hiddeco PTAL

[nitishfy]

@nitishfy we're looking to have 1.2 work done by 12/20 with plans to release after the winter break. Are you able to implement feedback before then?

Yes. The failing test case is the only blockage so far, once the CI checks are running I'll add the docs.

[krancour]

I'm not considering it a blocker, but because JSON schema can be tricky to mentally parse, unit tests that assert validations work as intended would be a nice-to-have.

[Marvin9]

if you could please update UI code as well - read this PR for reference (skip the icons)

[krancour]

@nitishfy thanks for applying all the feedback!

For docs, just add a new section to docs/docs/35-references/10-promotion-steps.md. Follow the format of existing step docs as closely as possible.

I would suggest the best place for this would be under the docs for the copy step.

@hiddeco, apart from docs, I think the only unresolved feedback was yours. Leaving final approval up to you.

[hiddeco]

Apart from the documentation, this also looks good to me.

[nitishfy]

Awesome, i'll go ahead and add the docs now.

[nitishfy]

Ready for the review.

[krancour]

@nitishfy thank you for all the hard work that went into this!