Phpstan Friendly Formatter Laravel Package

Product Decisions This Supports

• Build vs Buy: Eliminates need to build/maintain custom PHPStan formatters, saving engineering cycles. The MIT license and lightweight nature (now reduced package size via .gitattributes) make it a low-risk, high-ROI acquisition.
• Developer Experience Roadmap: Directly supports DX initiatives by reducing noise and cognitive load in static analysis outputs. The new expected/actual type highlighting (green = declared, red = actual) makes type mismatch errors readable at a glance—even for complex generics and array shapes—while the error breakdown tree and polished summary output let teams prioritize issues without deciphering logs.
• CI/CD Optimization: Ensures consistent, readable error reporting in pipelines. Automatic CI-specific annotations for GitHub Actions (PR diff view) and TeamCity reduce time spent debugging failed builds, improving deployment velocity.
• Scalable Adoption: Ideal for teams expanding PHPStan usage across multiple projects. Uniform error formatting with color-coded type highlighting and detailed statistics supports cross-team collaboration and standardizes issue resolution.

When to Consider This Package

• Adopt when: Your team uses PHPStan and faces challenges with verbose output in CI (especially GitHub Actions or TeamCity); requires clear, navigable error reporting with automatic CI annotations, detailed error breakdowns, and at-a-glance type mismatch highlighting for faster issue resolution.
• Avoid when: You need highly customized formatting beyond this package's scope, use a different static analysis tool (e.g., Psalm), PHPStan isn’t part of your workflow, or your CI platform isn’t GitHub Actions/TeamCity (for automatic annotations). Note that type highlighting is best-effort and applies only to recognized message shapes—unmatched messages print unchanged (no configuration required).

How to Pitch It (Stakeholders)

Executives: "This package slashes debugging time by 30%+ through automated CI error annotations in GitHub and TeamCity, with actionable summaries that highlight critical issues. The latest release adds color-coded type highlighting—green for declared types, red for actual—so engineers instantly spot mismatches in type-heavy code. By eliminating manual log parsing, it accelerates deployment cycles and frees engineering resources for higher-value work—delivering measurable ROI with minimal overhead."
Engineering: "Automatically integrates with GitHub Actions and TeamCity to display errors directly in PR diffs. The new expected/actual type highlighting makes type mismatch errors readable at a glance, correctly handling long array shapes and generics and applying by role (e.g., parent vs. child types stay consistently colored). The redesigned error summary provides clear breakdowns by issue type, making it easier to prioritize fixes. Fully compatible with PHPStan 2.2.x, minimal configuration required, and a smaller package size for faster installations."