feat: promote stages from freightline

[rbreeze]

[netlify]

✅ Deploy Preview for docs-kargo-akuity-io canceled.

Name	Link
🔨 Latest commit	2c5fa74
🔍 Latest deploy log	https://app.netlify.com/sites/docs-kargo-akuity-io/deploys/65015b0849f25a0008c30736

[codecov]

Codecov Report

Patch and project coverage have no change.

Comparison is base (c50e7bb) 46.56% compared to head (2c5fa74) 46.56%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #736   +/-   ##
=======================================
  Coverage   46.56%   46.56%           
=======================================
  Files          97       97           
  Lines        6748     6748           
=======================================
  Hits         3142     3142           
  Misses       3451     3451           
  Partials      155      155           

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

[jessesuen]

Issue 1: I can't tell the content of what is about to be promoted

Screen.Recording.2023-09-12.at.5.45.24.PM.mov

I think the confirmation should pop up below the freight instead of ontop of it. Something like:

[jessesuen]

Issue 2: Now that we have this UI, let's remove the availableFreight tab completely in stage view.

[jessesuen]

Issue 3: the freightline should be expanded by default to show more useful information:

NOTE: this is unrelated to the Promote button being added in this PR, but it has to do with Freightline in general so putting feedback here. It also may help address issue 1.

In the above screenshot, each box just shows freight ID (not that useful) and the same two icons for all items in the line (also not that useful). I propose we expand this by default and get rid of the pinning feature. It looks like we have enough left/right margin to compact the boxes if you are worried about freightline becoming too wide.

Clicking into a freight could still expand to show more metadata (git commit message, last seen, container repository). If we do this, pinning might still be useful.

[jessesuen]

Issue 4: We lost the messaging about downstream subscribers affected by the promotion.

I liked the level of detail that we previously provided when we clicked the PromoteSubscribers button, where we listed the Stages that would be affected by the promote. If we implement my suggestion in Issue 1, we should have enough space to present the same message we used to.

[rbreeze]

@jessesuen I've updated to address your comments, with some tweaks:

1. Instead of a popup, I simply expand the Freight box to include both the contents and the confirmation
2. Instead of writing which stages will be promoted, I highlight them in the DAG

[jessesuen]

I think that should be good enough for now. LGTM!