Skip to content

merge: expose --component-conflict-resolution; handle RenameRef refusal - #511

Open
jimklimov wants to merge 4 commits into
CycloneDX:mainfrom
jimklimov:merge-conflict-resolution
Open

jimklimov wants to merge 4 commits into
CycloneDX:mainfrom
jimklimov:merge-conflict-resolution

Conversation

@jimklimov

Copy link
Copy Markdown
Contributor

What

Exposes --component-conflict-resolution on merge, mapping to the library's MergeStrategy enum,
and handles the case where Bom.RenameRef() refuses to rename (target bom-ref already in use) by
surfacing a clear error instead of silently colliding.

Why

Surfaces the scope-conflict-resolution refinements from
cyclonedx-dotnet-library#447 at the
CLI layer. No earlier PR proposed this specifically.

Stacked on #509 (rename-entity, needed for the RenameEntityCommand.cs changes here) and #510
(merge-strategy-wiring, needed for MergeCommand.cs) — both must merge first. Depends on
cyclonedx-dotnet-library#446 and #447.

MergeCommand now calls CycloneDXUtils.FlatMerge/HierarchicalMerge with
MergeStrategy.Default() when built against a library that has it
(#if NET8_0_OR_GREATER, matching the library's own guard -- CLI is
net10.0-only today but this keeps the two projects' conditional
compilation symmetric and self-documenting), falling back to the
plain overload otherwise. No new CLI flags: strategy toggles are not
yet exposed at the command-line layer, so this only changes default
merge behavior, not the command's surface.

Signed-off-by: Jim Klimov <jimklimov@gmail.com>
Adds a "rename-entity" command that renames a bom-ref and every
back-reference to it throughout a BOM document, built on the
library's new BomRefWalker-based Bom.RenameRef(old, new) API. Follows
current System.CommandLine conventions
(System.CommandLine.NamingConventionBinder, not the older
System.CommandLine.Invocation namespace) and matches Convert/
MergeCommand's internal (not public) visibility.

Verified end-to-end against a real fixture: renaming a component's
bom-ref correctly rewrites both the dependsOn back-reference and the
dependency's own ref entry, and stamps fresh SerialNumber/Timestamp/
Tools metadata via BomMetadataUpdate/BomMetadataReferThisToolkit.

Wired into Program.cs (alphabetical position, between Merge and Sign),
guarded by #if NET8_0_OR_GREATER to match the library capability it
depends on.

Signed-off-by: Jim Klimov <jimklimov@gmail.com>
Follows MergeTests.cs conventions: direct handler call, TempDirectory,
Snapshooter with serialNumber/timestamp stripped (plus the tools list,
whose contents are build/environment-specific -- assembly versions and
"testhost" vs. the real CLI name under `dotnet test`). Covers a JSON
and an XML output round-trip of the rewrite-identifier-and-back-refs
case, plus a no-op case when the requested old-ref isn't present.

Full suite: 132 passed / 0 failed (129 pre-existing + 3 new).

Signed-off-by: Jim Klimov <jimklimov@gmail.com>
…usal

merge gains --component-conflict-resolution
<KeepSeparate|Squash_UpgradeScope|Squash_DowngradeScope|Squash_RenameByScope>,
defaulting to the library's MergeStrategy.Default() (Squash_UpgradeScope)
when not specified. This closes a pre-existing gap: the library-side
strategy was never selectable from the CLI at all -- it was always
hardcoded to Default() internally. Verified end-to-end: merging two
BOMs where the same component is "required" in one and "excluded" in
the other with --component-conflict-resolution Squash_RenameByScope
produces two distinct components (lp:scope=Required /
lp:scope=Excluded) with each source's dependsOn correctly pointing at
its own variant.

rename-entity now catches the InvalidOperationException
Bom.RenameRef throws when the requested new-ref collides with an
existing identifier, reporting it as a clean parameter-validation
error instead of an unhandled crash.

Signed-off-by: Jim Klimov <jimklimov@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant