[Racer159]

Description

This PR adds a Zarf package disassembly command to uds-cli - the goal is to take a built Zarf package and disassemble it into re-creatable source code that can be modified entirely offline. This is possible today manually with zarf tools archiver commands but this makes the process a bit more streamlined and intentional.

Related Issue

Fixes #N/A

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Other (security config, docs update, etc)

Checklist before merging

• Test, docs, adr added or updated as needed
• Contributor Guide Steps followed

[Racer159]

since I know is'a comin' - @greptileai review

[greptile-apps]

Confidence Score: 5/5

[High impact] The PR appears safe to merge because no blocking failure remains within the scope of this follow-up review.

Summary

This PR adds feature-gated workflows for converting complete Zarf packages into editable offline source trees and rebuilding them afterward.

• Adds package mod disassemble and package mod reassemble commands behind the PackageMod feature.
• Implements package asset recovery, source rewriting, metadata validation, and reassembly.
• Propagates normalized feature settings into the Next command tree while preserving the Zarf argument boundary.
• Adds unit, integration, cluster lifecycle, and documentation coverage.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  A[Complete Zarf package] --> B[package mod disassemble]
  B --> C[Editable source tree]
  C --> D[Modify and review source]
  D --> E[package mod reassemble]
  E --> F[Recreated Zarf package]

Loading

_{Reviews (3) · Last reviewed commit: "Merge branch 'main' into feat/add-disass..." · Reviewed by Greptile}

[Racer159]

Want to improve UX a little so moved back to draft - specifically thinking about how a chart edit might be needed... the zarf yaml I think can also use Zarf's helpers to be formatted a little cleaner and I want to explore that too.

[Racer159]

@greptileai review again on the final shape

[bradclawsie]

Great work. I've reviewed and did a guided reading of data flow. I round-tripped a zarf-init package from disassembly to reassembly (and then deployed the rebuilt package into a fresh cluster).

I had one edge case in another comment, but I am totally fine with applying that patch on my own if you have other things you want to move on to.

Otherwise, this is ready to merge. Let me know how you would like to proceed, and thanks again for this work.

[slaskawi]

LGTM! Let's get this in!

[chance-coleman]

lgtm

[joelmccoy]

Really late getting to this.. Took a very first pass and will do a deeper one soon, but wanted to callout the decision to feature flag. I disagree with this and would like to discuss. Left a comment on this and would love input from @slaskawi @chance-coleman @eoghanriley