apiops publish --delete-unmatched could fail to remove APIs with revisions because root and revision deletes were executed in an order APIM rejects (Cannot delete the current revision of an API). This left dependent resources undeletable in the same run.

• Delete orchestration fix (publish path)

  • In publish-service, API deletes are now processed separately from other resources.
  • API delete order is deterministic and revision-aware: revision descriptors are deleted before their root API descriptor, and API deletes run sequentially to avoid race/order conflicts inside the same API family.
  • Non-API resources keep parallel delete behavior.

• Unit coverage for regression and ordering

  • Added tests proving:
    • orders-api;rev=2 is deleted before orders-api.
    • Ordering remains deterministic across multiple API families (including revision + root pairs).

• Integration coverage for --delete-unmatched

  • Added a new round-trip phase (Phase 7, run-phase7-delete-unmatched.ps1) that:
    • removes a known revisioned API from extracted artifacts,
    • runs publish with --delete-unmatched,
    • verifies both revision and root API resources are removed from target APIM.
  • Renumbered subsequent round-trip phase labels so teardown is now Phase 8 (run-phase8-teardown.ps1).
  • Wired these updates into both the round-trip orchestrator and integration-test.yml.
  • Updated integration README to document the renumbered phases.

function orderApiDescriptorsForDelete(descriptors: ResourceDescriptor[]): ResourceDescriptor[] {
  return [...descriptors].sort((a, b) => {
    const aName = getNamePart(a.nameParts, 0);
    const bName = getNamePart(b.nameParts, 0);
    const aRoot = getApiRootName(aName);
    const bRoot = getApiRootName(bName);

    if (aRoot !== bRoot) return aRoot.localeCompare(bRoot);

    const aIsRevision = isApiRevisionName(aName);
    const bIsRevision = isApiRevisionName(bName);

    if (aIsRevision === bIsRevision) return aName.localeCompare(bName);
    return aIsRevision ? -1 : 1;
  });
}