phpstan.neon

# Decidesk — Conduction PHPStan config.
#
# The shared base is the single source of truth. Everything here is either the
# app's own tracked debt or an ignore naming a symbol that exists in no other
# fleet app. Anything you are tempted to add that another app would also need
# belongs in the base, not here.
includes:
    - vendor/conduction/hydra-gates/quality-config/phpstan-base.neon
    # One tracked entry left, and it is a security question rather than lint —
    # read the file's header before touching it. Not regenerated; entries are
    # removed one at a time as the underlying code is fixed.
    - phpstan-baseline.neon

parameters:
    # App-specific only. The base already sets level, paths, bootstrapFiles,
    # excludePaths, scanDirectories and every fleet-wide ignore.
    excludePaths:
        # These controllers extend OpenRegister AppHost base controllers that are only
        # available at runtime (dynamic app loading). PHPStan cannot resolve the parent
        # class during static analysis; the inheritance chain is guarded by runtime
        # app-availability checks in Application::register().
        - lib/Controller/DashboardController.php
        - lib/Controller/HealthController.php
        - lib/Controller/MetricsController.php

    scanFiles:
        # OpenRegister ships IMcpToolProvider at runtime only. "implements unknown
        # interface" is a non-ignorable PHPStan error, so hand it the same stub the
        # phpunit bootstrap uses instead of muting it — this analyses the contract
        # for real rather than suppressing it.
        - tests/Stubs/Mcp/IMcpToolProvider.php

    ignoreErrors:
        # NC Talk's room/conversation manager is an external app class not available during
        # analysis; it is resolved dynamically at runtime and guarded with method_exists(),
        # so phpstan infers stdClass and cannot see the real named-parameter signatures.
        - '#Unknown parameter \$(objectType|objectId|type|name) in call to method stdClass::(getRoomForObject|createConversationFromObject)\(\)#'