patchVerifier = $patchVerifier;
$this->magentoVersion = $magentoVersion;
}
/**
* @inheritDoc
*/
public function run(InputInterface $input, OutputInterface $output): int
{
$format = $input->getOption('format') ?? self::FORMAT_TABLE;
$patchIds = $input->getOption('patch-id');
// Enable cloud-only mode if requested (verify only Cloud patches from patches.json)
$cloudOnly = $input->getOption('cloud-only');
if ($cloudOnly) {
$this->patchVerifier->setCloudOnly(true);
if ($format !== self::FORMAT_JSON) {
$output->writeln(
'Cloud-only mode enabled - verifying only Cloud patches from patches.json'
);
$output->writeln('');
}
}
// Run verification
if (!empty($patchIds)) {
$report = $this->patchVerifier->verifySpecific($patchIds);
} else {
$report = $this->patchVerifier->verify();
}
// Output the report
if ($format === self::FORMAT_JSON) {
$this->outputJson($output, $report);
} else {
$this->outputTable($output, $report);
}
// Return appropriate exit code
return $report->isPassing() ? 0 : 1;
}
/**
* Outputs the report in JSON format.
*
* @param OutputInterface $output
* @param VerificationReport $report
* @return void
*/
private function outputJson(OutputInterface $output, VerificationReport $report): void
{
$output->writeln(json_encode($report->toArray(), JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
}
/**
* Outputs the report in table format.
*
* @param OutputInterface $output
* @param VerificationReport $report
* @return void
*
* @SuppressWarnings(PHPMD.CyclomaticComplexity)
* @SuppressWarnings(PHPMD.NPathComplexity)
*/
private function outputTable(OutputInterface $output, VerificationReport $report): void
{
$output->writeln('');
$output->writeln('═══════════════════════════════════════════════════════════');
$output->writeln(' Patch Application Verification Report ');
$output->writeln('═══════════════════════════════════════════════════════════');
$output->writeln('');
// Summary
$statusTag = $report->isPassing() ? 'info' : 'error';
$output->writeln(sprintf('<%s>%s', $statusTag, $report->getSummary(), $statusTag));
$output->writeln('');
// Statistics
$output->writeln('Statistics:');
$output->writeln(sprintf(' Total Expected Patches: %d', $report->getTotalExpected()));
$output->writeln(sprintf(' Patches Applied: %d', $report->getTotalApplied()));
$missingCount = count($report->getMissingPatches());
$unexpectedCount = count($report->getUnexpectedPatches());
$output->writeln(sprintf(' Missing Patches: %d', $missingCount));
$output->writeln(sprintf(' Unexpected Patches: %d', $unexpectedCount));
$compliance = $report->getCompliancePercentage();
$output->writeln(sprintf(' Compliance: %.2f%%', $compliance));
$output->writeln('');
// Missing patches (failures)
if (!empty($report->getMissingPatches())) {
$output->writeln('Missing Patches (Expected but Not Applied):');
$output->writeln('───────────────────────────────────────────────────────────');
foreach ($report->getMissingPatches() as $patch) {
$output->writeln(sprintf(' ✗ %s', $patch['id']));
$output->writeln(sprintf(' Title: %s', $patch['title']));
$output->writeln(sprintf(' Type: %s', $patch['type']));
$output->writeln(sprintf(' Origin: %s', $patch['origin']));
if (!empty($patch['categories'])) {
$output->writeln(sprintf(' Categories: %s', implode(', ', $patch['categories'])));
}
if (isset($patch['note'])) {
$output->writeln(sprintf(' Note: %s', $patch['note']));
}
$output->writeln('');
}
}
// Unexpected patches (informational)
if (!empty($report->getUnexpectedPatches())) {
$output->writeln('Unexpected Patches (Applied but Not Expected):');
$output->writeln('───────────────────────────────────────────────────────────');
foreach ($report->getUnexpectedPatches() as $patch) {
$output->writeln(sprintf(' ⚠ %s', $patch['id']));
$output->writeln(sprintf(' Title: %s', $patch['title']));
$output->writeln('');
}
}
// Applied patches summary
if ($report->getTotalApplied() > 0 && empty($report->getMissingPatches())) {
$output->writeln('✓ All Expected Patches Applied Successfully');
$output->writeln('');
}
$output->writeln('═══════════════════════════════════════════════════════════');
$output->writeln('');
// Recommendations
if (!$report->isPassing()) {
$output->writeln('Recommendations:');
$output->writeln(' • Review missing patches and determine if they should be applied');
$output->writeln(' • Check environment configuration that may prevent patch application');
$output->writeln(' • Verify Magento version compatibility with missing patches');
$output->writeln(' • Run: ./vendor/bin/ece-patches status for detailed patch status');
$output->writeln(' • Run: ./vendor/bin/ece-patches apply to apply missing patches');
$output->writeln('');
}
}
}