chore: standardize automatic skill sources and PHPDoc bootstrap (#16)

* chore: standardize skill sources and PHPDoc bootstrap

* fix: satisfy full quality checks without bypasses

Author: coisa

.changelog/consistent-skill-sources.md

@@ -0,0 +1,11 @@
+---
+category: changed
+type: patch
+---
+
+Synchronize the bundled local skill automatically and trust Fast Forward Composer
+skill donors through `fast-forward/*`.
+Resolve Changelog contributor skills from stable `0.4.x` releases without a
+redundant skill allowlist.
+Load the project autoloader for PHPDoc checks when DevTools is installed as a
+dependency.

.gitattributes

@@ -13,3 +13,4 @@
 /phpunit.xml.dist      export-ignore
 /README*.md             export-ignore
 /skills.json export-ignore
+/.php-cs-fixer.dist.php export-ignore

.php-cs-fixer.dist.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Ergonomic utilities for PHP enums, including names, values, lookups, and option maps.
+ *
+ * This file is part of fast-forward/enum project.
+ *
+ * @author   Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license  https://opensource.org/licenses/MIT MIT License
+ *
+ * @see      https://github.com/php-fast-forward/enum
+ * @see      https://github.com/php-fast-forward/enum/issues
+ * @see      https://php-fast-forward.github.io/enum/
+ * @see      https://datatracker.ietf.org/doc/html/rfc2119
+ */
+
+use FastForward\DevTools\Path\WorkingProjectPathResolver;
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
+
+require __DIR__ . '/vendor/autoload.php';
+
+return (new Config())
+    ->setRiskyAllowed(false)
+    ->setFinder(Finder::create()->in(__DIR__)->exclude(WorkingProjectPathResolver::TOOLING_EXCLUDED_DIRECTORIES))
+    ->setRules([
+        'phpdoc_indent' => true,
+        'phpdoc_order' => ['order' => ['param', 'return', 'throws']],
+        'phpdoc_separation' => true,
+        'phpdoc_trim' => true,
+        'phpdoc_trim_consecutive_blank_line_separation' => true,
+        'phpdoc_scalar' => true,
+        'phpdoc_types' => true,
+        'phpdoc_to_comment' => false,
+        'phpdoc_add_missing_param_annotation' => true,
+    ]);

composer.json

@@ -62,10 +62,10 @@
         "allow-plugins": {
             "ergebnis/composer-normalize": true,
             "fast-forward/dev-tools": true,
+            "llm/skills": true,
             "phpdocumentor/shim": true,
             "phpro/grumphp-shim": true,
-            "pyrech/composer-changelogs": true,
-            "llm/skills": true
+            "pyrech/composer-changelogs": true
         },
         "platform": {
             "php": "8.3.0"

skills.json

@@ -1,21 +1,27 @@
 {
-    "$schema": "https://raw.githubusercontent.com/roxblnfk/skills/master/resources/skills.schema.json",
+    "$schema": "https://raw.githubusercontent.com/roxblnfk/skills/1.15.0/resources/skills.schema.json",
     "target": ".agents/skills",
     "aliases": [],
     "discovery": false,
     "auto-sync": true,
     "vendor-sources": false,
     "dependencies": {
-        "composer": false
+        "composer": {
+            "trusted": [
+                "fast-forward/*"
+            ],
+            "trusted-replace": true
+        }
     },
     "sources": [
+        {
+            "from": "dir",
+            "path": "resources/skills"
+        },
         {
             "from": "github",
             "package": "php-fast-forward/changelog",
-            "ref": "^0.3.0",
-            "skills": [
-                "fast-forward-changelog"
-            ]
+            "ref": "^0.4.0"
         }
     ]
 }

src/Calendar/Quarter.php

@@ -107,8 +107,6 @@ public static function ordered(): array
 
     /**
      * @param Month $month
-     *
-     * @return self
      */
     public static function fromMonth(Month $month): self
     {

src/Calendar/Semester.php

@@ -111,8 +111,6 @@ public function includes(Month $month): bool
 
     /**
      * @param Month $month
-     *
-     * @return self
      */
     public static function fromMonth(Month $month): self
     {
@@ -121,8 +119,6 @@ public static function fromMonth(Month $month): self
 
     /**
      * @param Quarter $quarter
-     *
-     * @return self
      */
     public static function fromQuarter(Quarter $quarter): self
     {

src/Sort/ComparisonResult.php

@@ -38,8 +38,6 @@ enum ComparisonResult implements ReversibleInterface
 
     /**
      * @param int $result
-     *
-     * @return self
      */
     public static function fromComparisonResult(int $result): self
     {

src/StateMachine/InvalidTransitionException.php

@@ -26,8 +26,6 @@ final class InvalidTransitionException extends DomainException
     /**
      * @param UnitEnum $from
      * @param UnitEnum $to
-     *
-     * @return self
      */
     public static function between(UnitEnum $from, UnitEnum $to): self
     {

src/Trait/HasNameLookup.php

@@ -24,8 +24,6 @@ trait HasNameLookup
 {
     /**
      * @param string $name
-     *
-     * @return self|null
      */
     public static function tryFromName(string $name): ?self
     {
@@ -37,8 +35,6 @@ public static function tryFromName(string $name): ?self
 
     /**
      * @param string $name
-     *
-     * @return self
      */
     public static function fromName(string $name): self
     {