* Checks whether a path exists and is a regular file. * * @param {string} filePath Absolute or relative file path. * @returns {boolean} True when t

* Load JSON file safely

* Save current sync state

* Call Claude API

* Write JSON file with directory creation

* Build the prompt for AI analysis

* Extracts lightweight hints from a phpstan.neon config. * * This does not parse NEON. It only checks for common directive tokens so the * agent ca

* Builds a JSON report describing the current repository's PHPStan setup. * * @returns {object} A stable, machine-readable inspection report.

* Build prompt for generating skill updates

* Detect what changed between last sync and current state

* Extracts stub-like package references from a PHPStan config. * * The PHPStan config usually references stubs via vendor paths (for example, * "ve

* Detects which Composer scripts invoke PHPStan. * * This helps the agent prefer the repo's own invocation (memory limits, * config, bootstrap file

* Get current upstream state hash for comparison

* Load last sync state

* Load a skill's SKILL.md content

* Load all reference docs for a skill

* Load all current upstream indices

* Main execution

* CLI entrypoint for printing the inspection report.

* Normalizes Composer script entries into a flat list of commands. * * Composer allows scripts to be strings or arrays. This helper provides a * co

* Reads and parses JSON from a file path. * * Returns null when parsing fails so the caller can provide user-facing * guidance without crashing. *

* Reads a UTF-8 text file. * * Returns null when reading fails so callers can surface missing configs * without crashing. * * @param {string} fil