Appendix

This section collects reference material that applies to the package as a whole rather than to any specific feature or implementation. It covers the legal terms under which the package is distributed and the practical expectations for contributors. For implementation details, see the Core Implementation section. For configuration file references, see Configuration Reference.

---

License

The package is distributed under the MIT License.

Field	Value
License	MIT
Copyright holder	Invokable
Copyright year	2025

The full license text is recorded in LICENSE1-21 Key terms:

• Permission is granted to use, copy, modify, merge, publish, distribute, sublicense, and sell copies of the software without restriction.
• The copyright notice and permission notice must be included in all copies or substantial portions of the software.
• The software is provided "as is", without warranty of any kind. The authors are not liable for any claim, damages, or other liability arising from use of the software.

The MIT License is a permissive open-source license. It imposes no restrictions on commercial use, private use, or sublicensing, provided attribution is preserved.

For the full license text in the repository, see LICENSE1-21

Sources: LICENSE1-21

---

Contributing Guidelines

The following summarises the expectations for contributors to this package. For tool-specific configuration details, see Code Quality Configuration and Testing Configuration.

Code Style

The package enforces code style via Laravel Pint with the laravel preset. Additional rules configured in pint.json include:

• strict_comparison — enforces === over ==
• declare_strict_types — requires declare(strict_types=1) in every PHP file

Run the linter before submitting:

composer lint # auto-fix
composer test:lint # check only

Sources: pint.json

Testing

The test suite uses Pest 4. All tests must pass before a pull request can be merged.

Run the full suite:

composer test

The CI matrix runs tests against PHP 8.3, 8.4, and 8.5. See CI/CD Pipeline for the full matrix configuration.

Key test files:

File	What it covers
tests/PhpStormCopilotTest.php	Detection config, path helpers, WSL transform logic
tests/PhpStormCopilotServiceProviderTest.php	Service provider registration

Sources: phpunit.xml tests/PhpStormCopilotTest.php

Distribution Releases and Excluded Files

The .gitattributes file marks development-only files with export-ignore, so they are excluded from Composer release archives. Contributors should not remove these annotations.

The following are excluded from distribution:

/.github export-ignore
/tests export-ignore
.editorconfig export-ignore
.gitattributes export-ignore
.gitignore export-ignore
phpunit.xml export-ignore
pint.json export-ignore
boost.json export-ignore
testbench.yaml export-ignore
/workbench export-ignore

Only the files that end users need at runtime are included in a release: src/, resources/, composer.json, LICENSE, and README.md.

Sources: .gitattributes1-16

Contribution Workflow Summary

Sources: .gitattributes1-16 LICENSE1-21

---

Sub-Pages

Section	Title	Purpose
9.1	License	Full MIT license text and copyright details
9.2	Contributing Guidelines	Code style, testing, CI checks, and export-ignore rules in depth