[eoghanriley]

Description

This PR aligns our public ZarfPackageLayout withe the zarf type by renaming some fields and moving IsPartial out to a new type ZarfPackageLayoutLoadResult

Related Issue

Fixes CLI-207

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

[greptile-apps]

Greptile Summary

The PR aligns the public package-layout API with Zarf’s layout model and moves partial-layout metadata into dedicated load-result and deployment-option types.

• External package loaders now stage complete packages in the adapter-owned destination directory.
• The adapter reloads staged package data before applying supported public mutations, preserving private deployment fields.
• Partial-layout state is propagated independently through loader results and deploy hooks.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
pkg/bundle/zarf.go	The adapter now assigns the supplied staging directory internally, reloads the complete Zarf layout, and reapplies public mutations without discarding private deployment data.
pkg/bundle/deploy.go	Public loader and hook contracts now carry partial-layout metadata separately from ZarfPackageLayout.
internal/zarf/layout.go	Internal layout loaders now return a structured result containing the loaded layout and partial-state metadata.
internal/zarf/deploy.go	Package deployment consumes the structured load result and propagates its layout and partial state.
pkg/bundle/zarf_test.go	Tests cover staged private-data preservation, partial metadata, staging ownership, and rejection of unstaged loader results.

Sequence Diagram

sequenceDiagram
    participant Loader as Public layout loader
    participant Stage as Adapter-owned staging directory
    participant Adapter as Package layout adapter
    participant Zarf as Zarf deployment
    Loader->>Stage: Stage complete package
    Loader-->>Adapter: Layout mutations and IsPartial
    Adapter->>Stage: LoadFromDir
    Stage-->>Adapter: Complete private deployment state
    Adapter->>Adapter: Apply supported public mutations
    Adapter->>Zarf: Deploy reconstructed layout

Loading

_{Reviews (2): Last reviewed commit: "fix: enforce ZarfPackageLayout dirPath b..." | Re-trigger Greptile}

[chance-coleman]

lgtm