Merge remote-tracking branch 'origin/develop' into issue-29

# Conflicts:
#	config/autoload/local.php.dist
#	src/App/src/ConfigProvider.php
#	src/App/src/RoutesDelegator.php

Author: OStefan2001

.gitignore

@@ -52,3 +52,7 @@ package-lock.json
 **/.DS_Store
 
 public/uploads/
+
+# Generated by bin/generate-packages (daily cron); not tracked so it never conflicts on pull
+/public/packages.json
+/public/packages.json.tmp

bin/generate-packages

@@ -0,0 +1,60 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Rebuilds the Dotkernel packages listing from the GitHub organisation.
+ *
+ * Intended to run from cron, e.g. daily:
+ *   0 4 * * * cd /path/to/dotkernel.com && /usr/bin/php bin/generate-packages >> log/generate-packages.log 2>&1
+ *
+ * Exits non-zero without touching the data file when the run cannot be trusted, so the
+ * previously generated listing keeps serving.
+ */
+
+declare(strict_types=1);
+
+use Light\App\Service\PackageGenerator;
+
+chdir(__DIR__ . '/../');
+
+require 'vendor/autoload.php';
+
+$container        = require 'config/container.php';
+$packageGenerator = $container->get(PackageGenerator::class);
+
+try {
+    $report = $packageGenerator->write();
+} catch (Throwable $exception) {
+    fwrite(STDERR, sprintf(
+        '[%s] generate-packages failed: %s%s',
+        date('c'),
+        $exception->getMessage(),
+        PHP_EOL
+    ));
+    exit(1);
+}
+
+printf(
+    '[%s] Done. %d package%s written to %s%s',
+    date('c'),
+    $report['written'],
+    $report['written'] === 1 ? '' : 's',
+    $packageGenerator->getDataFile(),
+    PHP_EOL
+);
+
+if ($report['skipped'] !== []) {
+    printf('Skipped by ignoreRepos: %s%s', implode(', ', $report['skipped']), PHP_EOL);
+}
+
+if ($report['ignoredMisses'] !== []) {
+    printf(
+        'WARNING: ignoreRepos entries matched nothing (renamed or deleted?): %s%s',
+        implode(', ', $report['ignoredMisses']),
+        PHP_EOL
+    );
+}
+
+foreach ($report['warnings'] as $warning) {
+    printf('WARNING: %s%s', $warning, PHP_EOL);
+}

bin/update-path-opengraph-images

@@ -27,6 +27,7 @@
     },
     "require": {
         "php": "~8.5.0",
+        "ext-curl": "*",
         "ext-dom": "*",
         "doctrine/data-fixtures": "^2.2",
         "doctrine/doctrine-fixtures-bundle": "^4.3",

composer.json

@@ -59,16 +59,27 @@ return [
     'feed'                 => [
         'path' => realpath(__DIR__ . '/../../public/feed.xml'),
     ],
+    /**
+     * Credentials for `bin/generate-packages`. Reading public repositories needs no token
+     * scopes at all; without a token the generator still runs, at a lower rate limit.
+     * Non-credential settings (ignore list, output path) live in `packages.global.php`.
+     */
+    'github'               => [
+        'userAgent'  => 'dotkernel.com',
+        'authBearer' => '',
+        'org'        => 'dotkernel',
+    ],
     'sitemap'              => [
         'path' => realpath(__DIR__ . '/../../public/sitemap.xml'),
     ],
+    // `dotkernel-packages-oss-lifecycle` is intentionally absent: it has a dedicated handler
+    // and is routed in Light\App\RoutesDelegator. Re-adding it here registers the path twice.
     'routes'               => [
         'page' => [
-            'contact'                          => 'contact',
-            'dotkernel-packages-oss-lifecycle' => 'dotkernel-packages-oss-lifecycle',
+            'contact' => 'contact',
         ],
     ],
-    'twig'                 => [
+    'twig'   => [
         'globals' => [
             'app' => $app,
         ],

config/autoload/local.php.dist

@@ -0,0 +1,77 @@
+<?php
+
+/**
+ * Dotkernel packages listing.
+ *
+ * Consumed by `bin/generate-packages`, which queries the GitHub organisation and writes the
+ * result to `dataFile`. Credentials are intentionally NOT stored here - the GitHub token lives
+ * in `config/autoload/local.php` under the `github` key, which is ignored by git.
+ *
+ * `local.php` is merged after every `*.global.php`, so any value below can be overridden locally.
+ */
+
+declare(strict_types=1);
+
+return [
+    'packages' => [
+        /**
+         * ignored repositories
+         * matched on the bare repository name (case-insensitive)
+         */
+        'ignoreRepos'     => [
+            '.github',
+            'admin',
+            'admin-documentation',
+            'apidemia.com',
+            'api',
+            'api-documentation',
+            'app-packages',
+            'api-tools-migration',
+            'core',
+            'development',
+            'documentation',
+            'documentation-theme',
+            'dotboost',
+            'dotkernel',
+            'dotkernel.com',
+            'dotkernel.github.io',
+            'dotkernel.org',
+            'dotkernel-v1',
+            'dot-opensearch',
+            'dot-privy',
+            'dot-queue',
+            'dot-sso-entra',
+            'frontend',
+            'frontend-documentation',
+            'fullview',
+            'headless-documentation',
+            'light',
+            'light-documentation',
+            'mezzio-hal',
+            'ng-admin',
+            'ngx-admin',
+            'php-llm-examples',
+            'pingu',
+            'plugin-mail-transporter',
+            'pong',
+            'presentation',
+            'queue',
+            'queue-documentation',
+            'template',
+            'template-expressive',
+            'tutorial-101',
+            'vue',
+            'workflow-automatic-releases',
+            'workflow-continuous-integration',
+            'workshops',
+            'ws-entities-collections',
+            'zend',
+            'zend-expressive-hal',
+            'zf1',
+        ],
+        'dataFile'        => __DIR__ . '/../../public/packages.json',
+        'includeArchived' => true,
+        'timeout'         => 10,
+        'connectTimeout'  => 5,
+    ],
+];