Use Fast Forward composer installer

Author: coisa

.github/workflows/tests.yml

@@ -53,7 +53,7 @@ jobs:
           test -d .agents/skills
           test -f .agents/agents/issue-implementer.md
           test -f .agents/skills/github-pull-request/SKILL.md
-          php -r '$composer = json_decode(file_get_contents("composer.json"), true, flags: JSON_THROW_ON_ERROR); if (($composer["type"] ?? null) !== "fast-forward-resource-bundle") { exit(1); } if (($composer["extra"]["installer-name"] ?? null) !== "agents") { exit(1); } if (($composer["extra"]["fast-forward-bundle"]["installer-path"] ?? null) !== ".agents/{\$name}/") { exit(1); }'
+          php -r '$composer = json_decode(file_get_contents("composer.json"), true, flags: JSON_THROW_ON_ERROR); if (($composer["type"] ?? null) !== "fast-forward-resource-bundle") { exit(1); } if (($composer["require"]["fast-forward/composer-installers"] ?? null) !== "dev-main") { exit(1); } if (($composer["extra"]["fast-forward-bundle"]["payload-path"] ?? null) !== ".agents") { exit(1); }'
 
       - name: Publish required test status
         if: ${{ always() && inputs.publish-required-statuses }}

README.md

@@ -10,30 +10,32 @@ package split tracked by [php-fast-forward/dev-tools#195](https://github.com/php
 
 The package uses the custom Composer type `fast-forward-resource-bundle`.
 Consumer repositories are expected to install Fast Forward resource bundles
-through Composer installer paths instead of copying or linking package contents
-manually.
+through `fast-forward/composer-installers` instead of copying or linking package
+contents manually.
 
 ```json
 {
+  "require": {
+    "fast-forward/agents": "dev-main"
+  },
   "config": {
     "allow-plugins": {
-      "composer/installers": true,
-      "oomphinc/composer-installers-extender": true
+      "fast-forward/composer-installers": true
     }
   },
   "extra": {
-    "installer-types": ["fast-forward-resource-bundle"],
     "installer-paths": {
-      ".agents/{$name}/": ["fast-forward/agents"]
+      ".agents/": ["fast-forward/agents"]
     }
   }
 }
 ```
 
-`composer/installers` is required by this package so consumers do not need to
-require it explicitly. Because `fast-forward-resource-bundle` is a Fast Forward
-package type rather than one of the finite built-in `composer/installers` types,
-this package also requires `oomphinc/composer-installers-extender`.
+`fast-forward/composer-installers` is required by this package so consumers do
+not need to require the installer explicitly once the package is available from
+normal Composer metadata. Until the first tagged installer release exists,
+consumer smoke projects can add a repository entry for
+`php-fast-forward/composer-installers` and install the `dev-main` version.
 
 The resource-bundle type is intentionally generic. Each bundle can still install
 to a different target by using a package-specific installer-path match. For
@@ -43,18 +45,19 @@ could declare:
 ```json
 {
   "extra": {
-    "installer-types": ["fast-forward-resource-bundle"],
     "installer-paths": {
-      ".agents/{$name}/": ["fast-forward/agents"],
-      ".github/workflows/{$name}/": ["fast-forward/github-workflows"]
+      ".agents/": ["fast-forward/agents"],
+      ".github/workflows/": ["fast-forward/github-workflows"]
     }
   }
 }
 ```
 
-Consumer roots still own the plugin allow-list and the `installer-types` /
-`installer-paths` entries because Composer treats those settings as root
-configuration.
+Consumer roots still own the plugin allow-list and the `installer-paths` entries
+because Composer treats those settings as root configuration. The installer
+copies only the declared payload contents into each target, so `fast-forward/agents`
+materializes `.agents/agents` and `.agents/skills` directly under the consumer
+`.agents/` directory.
 
 `fast-forward/dev-tools` will use that stable installed package path in a later
 change so consumer sync commands can resolve packaged agent assets without

composer.json

@@ -26,6 +26,12 @@
         "source": "https://github.com/php-fast-forward/agents",
         "docs": "https://php-fast-forward.github.io/agents/"
     },
+    "repositories": [
+        {
+            "type": "vcs",
+            "url": "https://github.com/php-fast-forward/composer-installers"
+        }
+    ],
     "funding": [
         {
             "type": "github",
@@ -38,14 +44,13 @@
     ],
     "require": {
         "php": "^8.3",
-        "composer/installers": "^2.3",
-        "oomphinc/composer-installers-extender": "^2.0"
+        "fast-forward/composer-installers": "dev-main"
     },
-    "minimum-stability": "stable",
+    "minimum-stability": "dev",
+    "prefer-stable": true,
     "config": {
         "allow-plugins": {
-            "composer/installers": true,
-            "oomphinc/composer-installers-extender": true
+            "fast-forward/composer-installers": true
         },
         "platform": {
             "php": "8.3.0"
@@ -57,15 +62,11 @@
             "dev-main": "1.x-dev"
         },
         "fast-forward-bundle": {
-            "installer-path": ".agents/{$name}/",
-            "installer-path-match": "fast-forward/agents",
-            "installer-type": "fast-forward-resource-bundle",
             "kind": "agents",
             "payload-path": ".agents",
             "project-agents-path": ".agents/agents",
             "skills-path": ".agents/skills"
-        },
-        "installer-name": "agents"
+        }
     },
     "scripts": {
         "dev-tools": "composer global exec dev-tools -- --working-dir=\"$PWD\"",

docs/index.rst

@@ -20,31 +20,33 @@ Composer Installation
 ---------------------
 
 Consumer repositories are expected to install Fast Forward resource bundles with
-Composer installer paths:
+``fast-forward/composer-installers``:
 
 .. code-block:: json
 
    {
+     "require": {
+       "fast-forward/agents": "dev-main"
+     },
      "config": {
        "allow-plugins": {
-         "composer/installers": true,
-         "oomphinc/composer-installers-extender": true
+         "fast-forward/composer-installers": true
        }
      },
      "extra": {
-       "installer-types": ["fast-forward-resource-bundle"],
        "installer-paths": {
-         ".agents/{$name}/": ["fast-forward/agents"]
+         ".agents/": ["fast-forward/agents"]
        }
      }
    }
 
-``composer/installers`` is a package dependency of this bundle, so consumers do
-not need to require it separately. The custom ``fast-forward-resource-bundle`` type
-is outside the finite list handled directly by ``composer/installers``, so the
-bundle also requires ``oomphinc/composer-installers-extender``. Consumer roots
-still own the plugin allow-list and the ``installer-types`` /
-``installer-paths`` configuration.
+``fast-forward/composer-installers`` is a package dependency of this bundle, so
+consumers do not need to require the installer separately once the package is
+available from normal Composer metadata. Until the first tagged installer
+release exists, consumer smoke projects can add a repository entry for
+``php-fast-forward/composer-installers`` and install the ``dev-main`` version.
+Consumer roots still own the plugin allow-list and the ``installer-paths``
+configuration.
 
 The resource-bundle type is generic on purpose. Different bundle kinds can still
 install into different target directories by matching explicit package names in
@@ -54,16 +56,18 @@ install into different target directories by matching explicit package names in
 
    {
      "extra": {
-       "installer-types": ["fast-forward-resource-bundle"],
        "installer-paths": {
-         ".agents/{$name}/": ["fast-forward/agents"],
-         ".github/workflows/{$name}/": ["fast-forward/github-workflows"]
+         ".agents/": ["fast-forward/agents"],
+         ".github/workflows/": ["fast-forward/github-workflows"]
        }
      }
    }
 
 This keeps the Composer type reusable while preserving one target directory per
-bundle package or bundle kind.
+bundle package or bundle kind. The installer copies only the declared payload
+contents into each target, so ``fast-forward/agents`` materializes
+``.agents/agents`` and ``.agents/skills`` directly under the consumer
+``.agents/`` directory.
 
 The follow-up ``fast-forward/dev-tools`` work tracked in
 `php-fast-forward/dev-tools#195 <https://github.com/php-fast-forward/dev-tools/issues/195>`_