feat(utils): implement custom logger with groups and tasks

[matejchalk]

Part of #888

This PR implements and tests a new custom Logger class, intended to replace our current logging with @poppinss/cliui, multi-progress-bars, etc. To minimize the scope of this PR, the new logger is unused. I've included a demo script and have tested the implementation manually in GitHub Actions and GitLab CI/CD. There's a comprehensive integration test suite and documentation.

Features

• Standardized colors for log levels (ansis).
• Automatically toggles debug logs depending on --verbose flag or CP_VERBOSE environment variable.
• Renders spinners for asynchronous tasks (ora).
• Render log groups, useful for executing plugins.
  • Supports spinners within groups.
  • Prefers native collapsible log groups if GITHUB_ACTIONS or GITLAB_CI environment detected.
• Automatically logs durations for async spinners and groups.
• Handles errors to ensure it's clear in which task an error was thrown. Also handles signal interruption.
• Propagates state (group, verbosity) to other logger instances, so logs from plugins should be rendered properly.

Examples

🎥 Default (local) - colors, spinners, groups

screen-capture.-.2025-10-17T175651.556.webm

🎥 Verbose - debug logs

screen-capture.-.2025-10-17T175515.228.webm

🎥 CI - spinners disabled

screen-capture.-.2025-10-17T180140.476.webm

🖼️ GitHub Actions - groups log lines using workflow commands (always collapsed by default)

source: workflow run

🖼️ GitLab CI/CD - renders collapsible sections (collapsed by default, unless verbose)

source: pipeline run

🎥 Error handling in plugin - completes spinner and group before re-throw

screen-capture.-.2025-10-17T180300.976.webm

🎥 Error handling in core - completes spinner before re-throw

screen-capture.-.2025-10-17T180344.316.webm

🎥 Error handling for SIGINT cancellation - completes spinner before exiting

screen-capture.-.2025-10-17T180603.703.webm

[nx-cloud]

View your CI Pipeline Execution ↗ for commit d3ff1a9

Command	Status	Duration	Result
nx code-pushup --nx-bail -- compare	✅ Succeeded	49s	View ↗
nx code-pushup --nx-bail --	✅ Succeeded	1m 3s	View ↗
nx code-pushup --nx-bail -- print-config --outp...	✅ Succeeded	3m 49s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-10-17 17:55:21 UTC

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 963eebd

Command	Status	Duration	Result
nx affected -t unit-test --parallel=3	❌ Failed	8s	View ↗
nx affected -t int-test --parallel=3	✅ Succeeded	6s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-10-17 15:44:27 UTC

[pkg-pr-new]

Open in StackBlitz

@code-pushup/ci

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/ci@1129

@code-pushup/cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/cli@1129

@code-pushup/core

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/core@1129

@code-pushup/create-cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/create-cli@1129

@code-pushup/models

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/models@1129

@code-pushup/nx-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/nx-plugin@1129

@code-pushup/coverage-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/coverage-plugin@1129

@code-pushup/eslint-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/eslint-plugin@1129

@code-pushup/js-packages-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/js-packages-plugin@1129

@code-pushup/jsdocs-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/jsdocs-plugin@1129

@code-pushup/lighthouse-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/lighthouse-plugin@1129

@code-pushup/typescript-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/typescript-plugin@1129

@code-pushup/utils

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/utils@1129

@code-pushup/models-transformers

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/models-transformers@1129

commit: d3ff1a9

[github-actions]

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit d073ab6 with previous commit 42fa531.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 24	🔴 36
Performance	🔴 35	🔴 34
Updates	🟡 81	🟡 81
Code coverage	🟡 90	🟢 90
Security	🟡 56	🟡 56	–
Accessibility	🟢 92	🟢 92	–
Best Practices	🟢 100	🟢 100	–
SEO	🟡 61	🟡 61	–
Type Safety	🟢 100	🟢 100	–
Bug prevention	🟢 100	🟢 100	–
Miscellaneous	🟢 100	🟢 100	–
Code style	🟢 100	🟢 100	–

👍 3 groups improved, 👎 1 group regressed, 👍 9 audits improved, 👎 4 audits regressed, 15 audits changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDoc coverage	Documentation coverage	🔴 24	🔴 36
Lighthouse	Performance	🔴 35	🔴 34
JS Packages	NPM outdated dependencies	🟡 81	🟡 81
Code coverage	Code coverage metrics	🟡 90	🟢 90

17 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
JSDoc coverage	Methods coverage	🟥 1 undocumented methods	🟨 9 undocumented methods
JSDoc coverage	Classes coverage	🟥 8 undocumented classes	🟥 8 undocumented classes
Lighthouse	First Contentful Paint	🟥 3.3 s	🟥 3.1 s
Lighthouse	Total Blocking Time	🟥 1,870 ms	🟥 2,420 ms
Lighthouse	Speed Index	🟥 7.2 s	🟥 7.3 s
Lighthouse	Time to Interactive	🟥 13.5 s	🟥 13.3 s
JS Packages	Outdated NPM prod dependencies.	🟨 16 outdated package versions (4 major, 8 minor, 4 patch)	🟨 16 outdated package versions (4 major, 8 minor, 4 patch)
JSDoc coverage	Variables coverage	🟥 292 undocumented variables	🟥 293 undocumented variables
Code coverage	Branch coverage	🟨 85.5 %	🟨 85.8 %
Code coverage	Line coverage	🟨 86.3 %	🟨 86.6 %
Code coverage	Function coverage	🟩 92.5 %	🟩 92.8 %
JSDoc coverage	Types coverage	🟥 241 undocumented types	🟥 243 undocumented types
JSDoc coverage	Functions coverage	🟥 520 undocumented functions	🟥 525 undocumented functions
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,033 KiB	🟩 Total size was 2,029 KiB
Lighthouse	Minimizes main-thread work	🟥 12.6 s	🟥 14.0 s
Lighthouse	Uses efficient cache policy on static assets	🟨 30 resources found	🟨 30 resources found
Lighthouse	Server Backend Latencies	🟩 2,070 ms	🟩 1,230 ms
Lighthouse	JavaScript execution time	🟥 5.0 s	🟥 5.6 s
Lighthouse	Largest Contentful Paint	🟥 12.0 s	🟥 11.4 s
Lighthouse	Initial server response time was short	🟥 Root document took 660 ms	🟥 Root document took 800 ms
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Remove duplicate modules in JavaScript bundles	🟥 Potential savings of 99 KiB	🟥 Potential savings of 99 KiB
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 180 KiB	🟥 Potential savings of 180 KiB
Lighthouse	Reduce unused CSS	🟥 Potential savings of 102 KiB	🟥 Potential savings of 102 KiB
Lighthouse	Max Potential First Input Delay	🟥 1,410 ms	🟥 1,430 ms
Lighthouse	Network Round Trip Times	🟩 50 ms	🟩 70 ms
JSDoc coverage	Properties coverage	🟥 4 undocumented properties	🟥 14 undocumented properties
Lighthouse	Cumulative Layout Shift	🟩 0	🟩 0

582 other audits are unchanged.

[vmasek]

awesome work 👏🏻