feat(store): fist stepts for implement ContributionStore for managing contributions in SQLite

chore(docker): update volume mappings for development environment
fix(provider): dedoupet base URL is properly formatted in GitLab and Gitea providers
2026-07-08 06:50:56 +02:00 · 2026-07-08 06:50:39 +02:00 · 2026-07-08 06:50:25 +02:00 · 2026-07-08 06:49:28 +02:00 · 2026-07-08 06:49:18 +02:00 · 2026-07-07 13:32:17 +02:00
53 changed files with 6926 additions and 384 deletions
@@ -1,10 +1 @@
-{
-    "hooks": {
-        "PostToolUse": [
-            {
-                "matcher": "Edit|Write",
-                "command": "php bin/phpunit 2>&1 | tail -20"
-            }
-        ]
-    }
-}
+{}
@@ -1,6 +1,37 @@
+# Build descriptors (not application code)
+Dockerfile*
+
+# Version control
 .git
 .gitea
+
+# AI / IDE tooling
+.claude
+
+# Dev tooling
+.gitignore
+/.phpunit.cache
+phpunit.xml.dist
+tests/
+
+# Documentation
+CHANGELOG.md
+CLAUDE.md
+README.md
+
+# Compose / deployment descriptors (not app code)
+docker-compose.yml
+docker-compose.override.yml
+docker-compose.prod.yml
+
+# Dependencies — re-installed from lockfile in the build stage;
+# a local vendor/ in the build context would silently override the clean install
+vendor/
+
+# Runtime dirs (generated at build or run time, not from source)
 var/
+
+# Env files — .env contains only placeholder defaults and is needed by composer dump-env;
+# local overrides with real secrets stay excluded
 .env.local
 .env.*.local
-docker-compose.override.yml
@@ -1,5 +1,5 @@
 APP_ENV=dev
-APP_DEBUG=0
+APP_DEBUG=1
 APP_SECRET=changeme_replace_with_random_32char_string

 # Comma-separated list of allowed hostnames. Leave empty to allow all hosts.
@@ -1,10 +1,10 @@
-# Builds and pushes a multi-arch Docker image to the Gitea container registry
-# whenever a semver tag (v*.*.*) is pushed.
+# Builds and pushes a multi-arch Docker image to the Gitea container registry.
+# Triggered manually via workflow_dispatch — enter an existing semver tag (e.g. 1.2.3)
+# in the "Release tag" input. The workflow will fail early if the tag does not exist.
 #
-# One-time setup required:
-#   1. Create a Gitea token with "package:write" scope.
-#   2. Add it as a repository secret named GITEA_TOKEN
-#      (Repository → Settings → Secrets → Actions).
+# Requires a repository secret REGISTRY_TOKEN — a Gitea PAT with write:package scope.
+# Create it at: Settings → Applications → Generate Token (scope: write:package)
+# Then add it: Repository → Settings → Secrets → Actions → REGISTRY_TOKEN
 #
 # After a successful run the image is available at:
 #   <your-gitea-host>/<owner>/<repo>:<version>
@@ -12,17 +12,33 @@
 name: Docker Publish

 on:
-  push:
-    tags:
-      - 'v*.*.*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag (semver, e.g. 1.2.3)"
+        required: true
+        type: string

 jobs:
  build-push:
    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: read

    steps:
      - name: Checkout
        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Validate tag exists
+        run: |
+          if ! git rev-parse "refs/tags/${{ inputs.tag }}" >/dev/null 2>&1; then
+            echo "Error: tag '${{ inputs.tag }}' does not exist in this repository."
+            exit 1
+          fi
+          git checkout "refs/tags/${{ inputs.tag }}"

      # Strip the protocol from the server URL to get the registry hostname.
      # e.g. https://gitea.example.com → gitea.example.com
@@ -30,17 +46,17 @@ jobs:
        run: |
          echo "REGISTRY=$(echo '${{ gitea.server_url }}' | sed 's|https://||;s|http://||')" >> $GITHUB_ENV

-      # Generates OCI-compliant tags and labels from the git tag.
-      # v1.2.3 → image tags: 1.2.3 / 1.2 / 1
+      # Generates OCI-compliant tags and labels from the provided release tag.
+      # 1.2.3 → image tags: 1.2.3 / 1.2 / 1
      - name: Extract Docker metadata
        id: meta
        uses: docker/metadata-action@v5
        with:
          images: ${{ env.REGISTRY }}/${{ gitea.repository }}
          tags: |
-            type=semver,pattern={{version}}
-            type=semver,pattern={{major}}.{{minor}}
-            type=semver,pattern={{major}}
+            type=semver,pattern={{version}},value=${{ inputs.tag }}
+          labels: |
+            org.opencontainers.image.source=${{ gitea.server_url }}/${{ gitea.repository }}

      # QEMU enables emulation of arm64 on the amd64 runner.
      - name: Set up QEMU
@@ -55,12 +71,24 @@ jobs:
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ gitea.actor }}
-          password: ${{ secrets.GITEA_TOKEN }}
+          password: ${{ secrets.REGISTRY_TOKEN }}
+
+      # Build a single-arch image locally so Trivy can inspect it before the real push.
+      - name: Build local image for scanning
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          target: final
+          platforms: linux/amd64
+          load: true
+          tags: scan-target:${{ inputs.tag }}
+          cache-from: type=registry,ref=${{ env.REGISTRY }}/${{ gitea.repository }}:buildcache

      - name: Build and push
        uses: docker/build-push-action@v5
        with:
          context: .
+          target: final
          platforms: linux/amd64,linux/arm64
          push: true
          tags: ${{ steps.meta.outputs.tags }}
@@ -3,5 +3,4 @@
 /vendor/
 /var/
 /public/bundles/
-composer.lock
 /.phpunit.cache
@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-05-30
+
+### Added
+
+- **FrankenPHP runtime** — base image migrated from `php-cli` to FrankenPHP Alpine for better performance and built-in web server support
+- **FrankenPHP worker mode** — Symfony worker script (`public/worker.php`) with request reuse and graceful reload
+- **Caddy configuration** — `docker/frankenphp/Caddyfile` and `Caddyfile.dev` for production and development setups
+- **Provider health probes** — `ProviderInterface` extended with `ping()` and `probe()` methods; `ProbeTrait` provides the shared implementation
+- **Per-provider status on `/health`** — the health endpoint now reports `ok`, `degraded`, or `down` for each configured provider (GitHub, GitLab, Gitea), along with an error code and latency
+- **Supporting value objects** — `ProviderStatus`, `ProviderStatusType`, `ProviderErrorCode`, and `ProviderHealthChecker` service
+- **`ContributionAggregator` service** — contribution merging logic extracted from `GraphController` into a dedicated, testable service
+
+### Fixed
+
+- Optional environment variables (`GITLAB_URL`, `ALLOWED_HOSTS`, etc.) now have explicit empty default values in `docker-compose.yml`, preventing Docker Compose warnings on startup
+
+### Changed
+
+- `SvgRenderer` is now `final` and declares `strict_types=1`
+
+### Tests
+
+- Unit tests added for `ProbeTrait`, `ProviderHealthChecker`, `ProviderStatus`, `ContributionAggregator`, and all three provider probes (`GitHubProvider`, `GitLabProvider`, `GiteaProvider`)
+- `SvgRendererTest` refactored to follow project PHPUnit conventions (`#[Test]` attribute, `it_` prefix, Arrange/Act/Assert structure)
+
+## [0.0.1] - 2025-01-01
+
+### Added
+
+- Initial release — GitHub, GitLab, and Gitea contribution graph as a self-hosted SVG endpoint
+- Light and dark theme support
+- Filesystem cache with 1-hour TTL
+- Docker multi-stage build (`base → deps → build → final`)
+- Basic `/health` endpoint
+
+[Unreleased]: https://github.com/ArthurErlich/git-contribution-graph/compare/0.1.0...HEAD
+[0.1.0]: https://github.com/ArthurErlich/git-contribution-graph/compare/0.0.1...0.1.0
+[0.0.1]: https://github.com/ArthurErlich/git-contribution-graph/releases/tag/0.0.1
@@ -77,14 +77,15 @@ Run vendor/bin/phpunit after each change to confirm tests stay green.
 **Common anti-patterns**

 | Wrong prompt                         | Why it breaks TDD                              | Correct prompt                                                           |
-|---|---|---|
+| ------------------------------------ | ---------------------------------------------- | ------------------------------------------------------------------------ |
 | "Write tests for this feature"       | Claude implements first, then fits tests to it | "Write **failing** tests for [feature]. Stop before any implementation." |
 | "Add tests and implementation"       | Loses the design feedback of failing tests     | Two separate prompts: Red, then Green                                    |
 | "Make the tests pass"                | Encourages skipping to a green state           | "Implement the minimum to make the failing tests pass."                  |
 | Combining Red + Green in one request | No failing baseline                            | Always separate the two phases                                           |

 ### Running tests
-Prever to use the tests in `docker compose exec graph`
+
+Prefer to use the tests in `docker compose exec graph`

 ```bash
 # Run full suite
@@ -100,6 +101,12 @@ vendor/bin/phpunit tests/Unit/Service/SvgRendererTest.php
 vendor/bin/phpunit --filter it_renders
 ```

+On Windows, run via WSL (If Docker Desctop is not):
+
+```powershell
+wsl -e bash -c "cd /mnt/g/_DEV/repos/git-contribution-graph && docker compose exec graph vendor/bin/phpunit --testdox 2>&1"
+```
+
 ### Auto-run hook

 Add to `.claude/settings.json` to run PHPUnit automatically after every file edit:
@@ -117,6 +124,24 @@ Add to `.claude/settings.json` to run PHPUnit automatically after every file edi
 }
 ```

+## Gitea Workflows
+
+Workflow files live in [.gitea/workflows/](.gitea/workflows/). This project uses Gitea Actions (GitHub Actions-compatible syntax).
+
+**When editing workflow files:**
+
+- Use `gitea.*` context variables, not `github.*` — e.g. `${{ gitea.server_url }}`, `${{ gitea.actor }}`, `${{ gitea.repository }}`
+- `GITHUB_ENV` and `GITHUB_OUTPUT` are still the correct env file names (Gitea Actions re-uses these)
+- Secrets are set under Repository → Settings → Secrets → Actions
+- The registry hostname must be derived from `gitea.server_url` (strip the protocol prefix)
+- Triggers use standard `on:` syntax; `tags: '*.*.*'` matches semver pushes without a `v` prefix
+
+**Current workflows:**
+
+| File                 | Trigger          | Purpose                                                   |
+| -------------------- | ---------------- | --------------------------------------------------------- |
+| `docker-publish.yml` | Push tag `*.*.*` | Build & push multi-arch image to Gitea container registry |
+
 ## Docker

 ### Development
@@ -192,7 +217,7 @@ GET /graph.svg?theme=dark|light
 ## Environment variables

 | Variable                                   | Required   | Notes                                        |
-|---|---|---|
+| ------------------------------------------ | ---------- | -------------------------------------------- |
 | `APP_SECRET`                               | Yes        | 32+ char random string                       |
 | `GITHUB_USER` / `GITHUB_TOKEN`             | For GitHub | Token scope: `read:user`                     |
 | `GITLAB_USER` / `GITLAB_TOKEN`             | For GitLab | Token scopes: `read_user`, `read_api`        |
@@ -1,10 +1,16 @@
-FROM php:8.3-cli-alpine AS base
+#syntax=docker/dockerfile:1

-RUN apk add --no-cache \
-    curl \
-    icu-libs \
-    libzip \
-    && docker-php-ext-install opcache
+FROM dunglas/frankenphp:1-php8.4-alpine AS base
+
+RUN apk add --no-cache icu-dev libzip-dev \
+    && docker-php-ext-install -j$(nproc) intl opcache zip \
+    && apk del icu-dev libzip-dev \
+    && apk add --no-cache curl icu-libs libzip \
+    && cp "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini" \
+    && mkdir -p $PHP_INI_DIR/app.conf.d
+
+ENV PHP_INI_SCAN_DIR=":$PHP_INI_DIR/app.conf.d"
+ENV COMPOSER_ALLOW_SUPERUSER=1

 WORKDIR /app

@@ -22,36 +28,33 @@ RUN composer install \
 # ── build stage (generate optimised classmap with source present) ──────────────
 FROM deps AS build
 COPY . .
-RUN composer dump-autoload --optimize --no-dev --no-interaction
-
-# ── dev stage (all deps + Xdebug, source is mounted at runtime) ───────────────
-FROM base AS dev
-COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
-RUN apk add --no-cache ${PHPIZE_DEPS} linux-headers \
-    && pecl install xdebug \
-    && docker-php-ext-enable xdebug \
-    && apk del ${PHPIZE_DEPS}
-COPY docker/php/xdebug.ini /usr/local/etc/php/conf.d/docker-xdebug.ini
-COPY composer.json composer.lock* ./
-RUN composer install --no-scripts --no-interaction --prefer-dist
-EXPOSE 8080
-ENV APP_ENV=dev APP_DEBUG=1
-CMD ["php", "-S", "0.0.0.0:8080", "-t", "public", "public/index.php"]
+RUN composer dump-autoload --classmap-authoritative --no-dev --no-interaction && \
+    mkdir -p var/cache var/log && \
+    APP_ENV=prod APP_SECRET=placeholder php bin/console cache:warmup --no-debug && \
+    composer dump-env prod

 # ── final (prod) stage — no composer binary ────────────────────────────────────
 FROM base AS final

 RUN addgroup -S app && adduser -S -G app app

-COPY --from=build /app/vendor /app/vendor
-COPY . .
+COPY --link --from=build /app/vendor /app/vendor
+COPY --link --from=build /app/var/cache/prod /app/var/cache/prod
+COPY --link bin/ ./bin/
+COPY --link config/ ./config/
+COPY --link public/ ./public/
+COPY --link src/ ./src/
+COPY --link composer.json composer.lock ./
+COPY --link docker/frankenphp/Caddyfile /etc/caddy/Caddyfile
+COPY --link docker/php/conf.d/20-app.prod.ini $PHP_INI_DIR/app.conf.d/

-RUN mkdir -p var/cache var/log \
-    && chown -R app:app /app
+RUN chmod +x bin/console && \
+    mkdir -p var/cache/prod/pools var/log /config/caddy /data/caddy && \
+    chown -R app:app /app /config /data

 USER app

 EXPOSE 8080
 ENV APP_ENV=prod APP_DEBUG=0

-CMD ["php", "-S", "0.0.0.0:8080", "-t", "public", "public/index.php"]
+CMD ["frankenphp", "run", "--config", "/etc/caddy/Caddyfile"]
@@ -0,0 +1,30 @@
+FROM dunglas/frankenphp:1-php8.4-alpine
+
+RUN apk add --no-cache icu-dev libzip-dev \
+    && docker-php-ext-install -j$(nproc) intl opcache zip \
+    && apk del icu-dev libzip-dev \
+    && apk add --no-cache curl icu-libs libzip \
+    && cp "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini" \
+    && mkdir -p $PHP_INI_DIR/app.conf.d
+
+COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
+
+RUN apk add --no-cache ${PHPIZE_DEPS} linux-headers \
+    && pecl install xdebug \
+    && docker-php-ext-enable xdebug \
+    && apk del ${PHPIZE_DEPS}
+
+ENV PHP_INI_SCAN_DIR=":$PHP_INI_DIR/app.conf.d"
+ENV COMPOSER_ALLOW_SUPERUSER=1
+
+WORKDIR /app
+
+COPY docker/php/xdebug.ini /usr/local/etc/php/conf.d/docker-xdebug.ini
+COPY docker/php/conf.d/20-app.dev.ini $PHP_INI_DIR/app.conf.d/
+COPY docker/frankenphp/Caddyfile.dev /etc/caddy/Caddyfile
+COPY composer.json composer.lock* ./
+RUN composer install --no-scripts --no-interaction --prefer-dist
+
+EXPOSE 8080
+ENV APP_ENV=dev APP_DEBUG=1
+CMD ["frankenphp", "run", "--config", "/etc/caddy/Caddyfile"]
@@ -6,7 +6,7 @@ A self-hosted Symfony service that merges contribution data from **GitHub**, **G
 https://your-host/graph.svg?theme=dark
 ```

-![Example graph](https://gitgraph.arthurerlich/graph.svg)
+![Example graph](https://gitgraph.arthurerlich.de/graph.svg)

 ---

@@ -27,15 +27,36 @@ https://your-host/graph.svg?theme=dark

 - Docker + Docker Compose

-### 1. Clone and configure
+### 1. Create a `docker-compose.yml`

-```bash
-git clone https://git.arthurerlich.de/haylan/git-contribution-graph.git
-cd git-contribution-graph
-cp .env .env.local
+Use the pre-built image
+
+```yaml
+services:
+  graph:
+    image: git.arthurerlich.de/haylan/git-contribution-graph:latest
+    ports:
+      - "8080:8080"
+    env_file:
+      - .env.local
+    volumes:
+      - cache:/var/www/html/var/cache
+
+volumes:
+  cache:
 ```

-Edit `.env.local` with your credentials:
+The image is published to the Gitea container registry. Pull it manually with:
+
+```bash
+docker pull git.arthurerlich.de/haylan/git-contribution-graph:latest
+```
+
+Semver tags are published (`0`, `0.0`, `0.0.1`) alongside `latest` — see the [container registry](https://git.arthurerlich.de/haylan/-/packages/container/git-contribution-graph/latest) for all available tags.
+
+### 2. Configure
+
+Create a `.env.local` file next to your `docker-compose.yml`:

 ```dotenv
 APP_SECRET=<generate with: openssl rand -hex 16>
@@ -60,7 +81,7 @@ ALLOWED_HOSTS=

 Only configure the platforms you use — unused ones are silently skipped.

-### 2. Start
+### 3. Start

 ```bash
 docker compose up -d
@@ -68,10 +89,11 @@ docker compose up -d

 The service listens on **port 8080** by default. Put Traefik or nginx in front of it for HTTPS.

-### 3. Health check
+### 4. Verify

-```
-GET /health  →  {"status":"ok"}
+```bash
+curl http://localhost:8080/health
+# {"status":"ok"}
 ```

 ---
@@ -0,0 +1,135 @@
+# TODO: persist contribution history in SQLite + audit cleanup
+
+Backend-only work. Follow Red → Green → Refactor per `CLAUDE.md` for every
+step that adds behavior (store, retention, provider `$since` handling).
+Order matters — later steps assume earlier ones are done.
+
+## 1. Audit cleanup
+
+- [x] **Remove `eightpoints/guzzle-bundle` + `idci/graphql-client-bundle`.**
+  They exist only to build one near-static GitHub GraphQL query string
+  (`GitHubProvider.php:59-74`); the bundle's own HTTP transport is already
+  bypassed (comment at `GitHubProvider.php:76-77`). 
+     - [ ] Replace
+  `$graphqlClient->buildQuery(...)->getGraphQLQuery()` with a plain
+  `sprintf`/heredoc query string. Delete the two packages from
+  `composer.json`, `config/bundles.php`, and delete
+  `config/packages/eight_points_guzzle.yaml` +
+  `config/packages/idci_graphql_client.yaml`. Run `composer update` and
+  commit the regenerated `composer.lock`.
+ 
+- [x] **Dedupe `baseUrl` normalization.** `GitLabProvider.php` (lines 41,
+  53) and `GiteaProvider.php` (lines 42, 54) each call
+  `rtrim($this->baseUrl..., '/')` twice — once in `ping()`, once in
+  `fetch()`. Compute it once as a `private readonly string $baseUrl` in
+  the constructor instead.
+
+## 2. Fix stale `config/services.yaml` (found during exploration, blocks step 1 & 4)
+
+- [ ] `services.yaml` still binds `$username`/`$token`/`$baseUrl` to the
+  pre-refactor FQCNs (`App\Service\GitHubProvider` etc.) and
+  `_instanceof: App\Service\ProviderInterface`, left over from the
+  `Service/` → `Provider/`+`Renderer/` namespace reorg. Update all of
+  these to `App\Service\Provider\...`. Currently these bindings silently
+  no-op, and scalar constructor args can't autowire without them — any
+  edit to these constructors (steps 1, 4) needs this fixed first, or the
+  container fails to compile.
+
+## 3. `ContributionStore` (SQLite via native PDO)
+
+- [x] New `src/Service/ContributionStore.php`. PDO SQLite, DB file at
+  `%kernel.project_dir%/var/data/contributions.db` (configurable
+  constructor arg), table created lazily:
+  ```sql
+  CREATE TABLE IF NOT EXISTS contributions (
+      provider TEXT NOT NULL,
+      date     TEXT NOT NULL,
+      count    INTEGER NOT NULL CHECK (count >= 0),
+      PRIMARY KEY (provider, date)
+  ) WITHOUT ROWID, STRICT;
+  ```
+- [ ] `latestDate(string $provider): ?string` — `SELECT MAX(date) WHERE provider = ?`.
+- [ ] `merge(string $provider, array $dateCounts): void` — upsert via
+  `INSERT ... ON CONFLICT(provider, date) DO UPDATE SET count = excluded.count`.
+- [ ] `all(string $provider, ?int $sinceDays = null): array` — `date => count`;
+  `null` returns full history (no arbitrary cutoff), a value filters to the
+  last N days.
+- [ ] `prune(): void` — `DELETE FROM contributions WHERE date < ?` using
+  the configured retention window; no-ops if retention is unset/0.
+- [ ] Constructor takes `?int $retentionDays` bound from new env var
+  `CONTRIBUTIONS_RETENTION_DAYS` (empty/default = keep forever).
+- [ ] Tests: `tests/Unit/Service/ContributionStoreTest.php` — store &
+  retrieve, upsert overwrites existing date, `sinceDays` filtering,
+  `prune()` no-ops when retention unset, `prune()` deletes rows older
+  than the window when set.
+
+## 4. Wire `$since` through providers
+
+- [ ] `ProviderInterface::fetch()` → `fetch(?\DateTimeImmutable $since = null): array`.
+- [ ] `GitHubProvider::fetch()` — use `$since ?? new \DateTimeImmutable('-365 days')`
+  for the GraphQL `from` param.
+- [ ] `GitLabProvider::fetch()` — same, feeds the `after` query param
+  (this is what actually shrinks the pagination loop).
+- [ ] `GiteaProvider::fetch()` — same, feeds the `$cutoff` timestamp filter.
+- [ ] Update `GitHubProviderTest.php` (drop `GraphQLApiClientRegistryInterface`
+  stub setup entirely per step 1), `GitLabProviderTest.php`,
+  `GiteaProviderTest.php` — add a case asserting a passed `$since` narrows
+  the request window.
+
+## 5. Wire `ContributionStore` into `ContributionAggregator`
+
+- [ ] Inject `ContributionStore` into `ContributionAggregator`.
+- [ ] Per configured provider: `$since = $store->latestDate($name)` → if
+  set, `(new \DateTimeImmutable($latest))->modify('-3 days')` (3-day
+  overlap for late corrections), else `null` (first run).
+- [ ] `$fresh = $provider->fetch($since)`, `$store->merge($name, $fresh)`,
+  then read back `$store->all($name, sinceDays: 371)` for the render
+  window (53 weeks × 7 days) and merge into the returned array.
+- [ ] Call `$store->prune()` once per `aggregate()` call, after all
+  providers have merged.
+- [ ] Keep the existing try/catch-and-log-per-provider behavior — a
+  provider failure leaves its DB history stale, doesn't break the render.
+- [ ] Update `ContributionAggregatorTest.php` with store-interaction and
+  prune-call cases.
+
+## 6. Docker / env
+
+- [ ] `docker-compose.yml` — add a `data` named volume mounted at
+  `/app/var/data` (same pattern as `cache`/`logs`), and pass through
+  `CONTRIBUTIONS_RETENTION_DAYS: "${CONTRIBUTIONS_RETENTION_DAYS:-}"`.
+- [ ] `Dockerfile` — add `var/data` to the `mkdir -p` in the `final` stage
+  alongside `var/cache/prod/pools var/log`, owned by `app`.
+- [ ] `.env` — document `CONTRIBUTIONS_RETENTION_DAYS` (empty by default),
+  same style as the existing `ALLOWED_HOSTS` comment.
+
+## 7. PHPStan
+
+- [ ] `composer require --dev phpstan/phpstan` (plain PHPStan — no
+  Symfony extension needed for this app's size).
+- [ ] Add `phpstan.neon`: `paths: [src, tests]`, `level: 8`.
+- [ ] Add composer script `"phpstan": "phpstan analyse"`.
+- [ ] Fix whatever level-8 flags on first run.
+
+## 8. `CLAUDE.md` update
+
+- [ ] Architecture section: add the `ContributionStore` (SQLite) tier
+  between providers and the renderer; note the two-tier cache (1h SVG
+  cache → SQLite raw-data store → provider APIs).
+- [ ] Environment variables table: add `CONTRIBUTIONS_RETENTION_DAYS`.
+- [ ] Development section: add `composer phpstan` next to the existing
+  `vendor/bin/phpunit` commands.
+- [ ] Remove any remaining mentions of the two deleted bundles.
+
+## Verification
+
+- `vendor/bin/phpunit --testdox` green after every step.
+- `composer phpstan` clean at level 8.
+- `composer install` succeeds with no dangling references to the removed bundles.
+- `docker compose up -d --build`; clear the FS cache
+  (`docker compose exec graph rm -rf var/cache/*`); hit
+  `/graph.svg?theme=dark` twice; check `docker compose logs -f graph` shows
+  a narrower `since` window on the second fetch.
+- Set `CONTRIBUTIONS_RETENTION_DAYS=30`; confirm rows older than 30 days
+  are gone after the next refresh
+  (`sqlite3 var/data/contributions.db "SELECT date FROM contributions ORDER BY date LIMIT 1"`).
+- `curl localhost:8080/health` still reports all configured providers healthy.
@@ -5,8 +5,6 @@
    "license": "MIT",
    "require": {
        "php": ">=8.2",
-        "eightpoints/guzzle-bundle": "^8.6",
-        "idci/graphql-client-bundle": "^2.0",
        "monolog/monolog": "^3.10",
        "symfony/cache": "7.4.*",
        "symfony/console": "7.4.*",
@@ -1,7 +0,0 @@
-eight_points_guzzle:
-    clients:
-        github_graphql:
-            base_url: 'https://api.github.com/graphql'
-            options:
-                headers:
-                    Authorization: 'Bearer %env(GITHUB_TOKEN)%'
@@ -7,3 +7,7 @@ framework:
    cache:
        app: cache.adapter.filesystem
        default_redis_provider: 'redis://localhost'
+    http_client:
+        default_options:
+            timeout: 10       # connect + wait-for-first-byte cap per request
+            max_duration: 15  # hard cap on total request duration
@@ -1,4 +0,0 @@
-idci_graphql_client:
-    clients:
-        github:
-            http_client: 'eight_points_guzzle.client.github_graphql'
@@ -121,7 +121,7 @@ use Symfony\Component\Config\Loader\ParamConfigurator as Param;
 * }
 * @psalm-type ServicesConfig = array{
 *     _defaults?: DefaultsType,
- *     _instanceof?: InstanceofType,
+ *     _instanceof?: array<class-string, InstanceofType>,
 *     ...<string, DefinitionType|AliasType|PrototypeType|StackType|ArgumentsType|null>
 * }
 * @psalm-type ExtensionType = array<string, mixed>
@@ -857,6 +857,7 @@ use Symfony\Component\Config\Loader\ParamConfigurator as Param;
 *             http_errors?: bool|Param,
 *             expect?: mixed,
 *             ssl_key?: mixed,
+ *             force_ip_resolve?: mixed, // Default: null
 *             stream?: bool|Param,
 *             synchronous?: bool|Param,
 *             read_timeout?: scalar|Param|null,
@@ -1,3 +1,15 @@
+parameters:
+    env(APP_SECRET): ''
+    env(ALLOWED_HOSTS): ''
+    env(GITHUB_USER): ''
+    env(GITHUB_TOKEN): ''
+    env(GITLAB_USER): ''
+    env(GITLAB_TOKEN): ''
+    env(GITLAB_URL): ''
+    env(GITEA_USER): ''
+    env(GITEA_TOKEN): ''
+    env(GITEA_URL): ''
+
 services:
    _defaults:
        autowire: true
@@ -10,21 +22,21 @@ services:
            - '../src/Kernel.php'

    _instanceof:
-        App\Service\ProviderInterface:
+        App\Service\Provider\ProviderInterface:
            tags: ['app.provider']

-    App\Service\GitHubProvider:
+    App\Service\Provider\GitHubProvider:
        arguments:
            $username: '%env(GITHUB_USER)%'
            $token: '%env(GITHUB_TOKEN)%'

-    App\Service\GitLabProvider:
+    App\Service\Provider\GitLabProvider:
        arguments:
            $username: '%env(GITLAB_USER)%'
            $token: '%env(GITLAB_TOKEN)%'
            $baseUrl: '%env(GITLAB_URL)%'

-    App\Service\GiteaProvider:
+    App\Service\Provider\GiteaProvider:
        arguments:
            $username: '%env(GITEA_USER)%'
            $token: '%env(GITEA_TOKEN)%'
@@ -3,10 +3,11 @@
 services:
  graph:
    build:
-      target: dev
+      dockerfile: Dockerfile.dev
    volumes:
      - .:/app
-      - /app/vendor        # keeps vendor from the dev image, not your local dir
+      - ./vendor:/app/vendor
+      - /app/var/data
    environment:
      APP_ENV: dev
      APP_DEBUG: "1"
@@ -0,0 +1,32 @@
+services:
+  graph:
+    image: git.arthurerlich.de/haylan/git-contribution-graph:latest
+    container_name: git-contribution-graph
+    restart: unless-stopped
+    ports:
+      - "8080:8080"
+    environment:
+      APP_ENV: prod
+      APP_DEBUG: "0"
+      APP_SECRET: "${APP_SECRET}"
+      ALLOWED_HOSTS: "${ALLOWED_HOSTS:-}"
+      GITHUB_USER: "${GITHUB_USER:-}"
+      GITHUB_TOKEN: "${GITHUB_TOKEN:-}"
+      GITLAB_USER: "${GITLAB_USER:-}"
+      GITLAB_TOKEN: "${GITLAB_TOKEN:-}"
+      GITLAB_URL: "${GITLAB_URL:-}"
+      GITEA_USER: "${GITEA_USER:-}"
+      GITEA_TOKEN: "${GITEA_TOKEN:-}"
+      GITEA_URL: "${GITEA_URL:-}"
+    volumes:
+      - cache:/app/var/cache/prod/pools
+      - logs:/app/var/log
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+
+volumes:
+  cache:
+  logs:
@@ -21,13 +21,14 @@ services:
      GITEA_TOKEN: "${GITEA_TOKEN:-}"
      GITEA_URL: "${GITEA_URL:-}"
    volumes:
-      - cache:/app/var/cache
+      - cache:/app/var/cache/prod/pools
      - logs:/app/var/log
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 30s
      timeout: 5s
      retries: 3
+      start_period: 10s

 volumes:
  cache:
@@ -0,0 +1,13 @@
+{
+    admin off
+    auto_https off
+
+    frankenphp {
+        worker /app/public/worker.php
+    }
+}
+
+:8080 {
+    root * /app/public
+    php_server
+}
@@ -0,0 +1,12 @@
+{
+    admin off
+    auto_https off
+    debug
+
+    frankenphp
+}
+
+:8080 {
+    root * /app/public
+    php_server
+}
@@ -0,0 +1,2 @@
+opcache.validate_timestamps=1
+opcache.revalidate_freq=0
@@ -0,0 +1,6 @@
+opcache.enable=1
+opcache.enable_cli=0
+opcache.memory_consumption=128
+opcache.max_accelerated_files=20000
+opcache.validate_timestamps=0
+expose_php=0
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Kernel;
+use Symfony\Component\HttpFoundation\Request;
+
+require_once dirname(__DIR__).'/vendor/autoload.php';
+
+$kernel = new Kernel($_SERVER['APP_ENV'] ?? 'prod', (bool) ($_SERVER['APP_DEBUG'] ?? false));
+$kernel->boot();
+
+$handler = static function () use ($kernel): void {
+    $request = Request::createFromGlobals();
+    $response = $kernel->handle($request);
+    $response->send();
+    $kernel->terminate($request, $response);
+};
+
+$maxRequests = (int) ($_SERVER['MAX_REQUESTS'] ?? 0);
+$requestCount = 0;
+
+while (\frankenphp_handle_request($handler)) {
+    if ($maxRequests > 0 && ++$requestCount >= $maxRequests) {
+        break;
+    }
+}
+
+$kernel->shutdown();
@@ -0,0 +1,29 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ],
+  "separateMajorMinor": true,
+  "major": {
+    "enabled": false
+  },
+  "packageRules": [
+    {
+      "allowedVersions": "^7.0",
+      "description": "Keep Symfony on 7.x LTS until EOL",
+      "matchPackageNames": [
+        "/^symfony//"
+      ]
+    },
+    {
+      "matchManagers": ["github-actions"],
+      "enabled": false,
+      "description": "Ignore GitHub Actions — no GITHUB_COM_TOKEN available"
+    },
+    {
+      "matchPackageNames": ["phpunit/phpunit"],
+      "allowedVersions": "^12.0",
+      "description": "Stay on PHPUnit 12.x (compatible with Symfony 7 / PHP 8.2+)"
+    }
+  ]
+}
@@ -1,12 +1,14 @@
 <?php

+declare(strict_types=1);
+
 namespace App\Controller;

-use App\Service\ProviderInterface;
-use App\Service\SvgRenderer;
+use App\Service\ContributionAggregator;
+use App\Service\Provider\ProviderHealthChecker;
+use App\Service\Renderer\SvgRenderer;
 use Psr\Log\LoggerInterface;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
-use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
 use Symfony\Component\HttpFoundation\RedirectResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
@@ -14,17 +16,17 @@ use Symfony\Component\Routing\Attribute\Route;
 use Symfony\Contracts\Cache\CacheInterface;
 use Symfony\Contracts\Cache\ItemInterface;

-class GraphController
+final class GraphController
 {
    /** @var list<string> */
    private readonly array $allowedHosts;

    public function __construct(
-        #[TaggedIterator('app.provider')]
-        private readonly iterable $providers,
+        private readonly ContributionAggregator $aggregator,
        private readonly SvgRenderer $renderer,
        private readonly CacheInterface $cache,
        private readonly LoggerInterface $logger,
+        private readonly ProviderHealthChecker $healthChecker,
        #[Autowire(env: 'ALLOWED_HOSTS')]
        string $allowedHosts = '',
    ) {
@@ -51,8 +53,9 @@ class GraphController
        $svg = $this->cache->get($cacheKey, function (ItemInterface $item) use ($theme, &$cacheMiss): string {
            $cacheMiss = true;
            $item->expiresAfter(3600);
+            set_time_limit(30); // ponytail: providers fetch concurrently now (cost ~= max, not sum); GitLab pagination + per-request HTTP timeout (framework.yaml) still need headroom over the 30s default

-            return $this->renderer->render($this->fetchAllContributions(), $theme);
+            return $this->renderer->render($this->aggregator->aggregate(), $theme);
        });

        $this->logger->debug('GraphController: cache ' . ($cacheMiss ? 'miss' : 'hit'), ['theme' => $theme]);
@@ -75,37 +78,13 @@ class GraphController
    #[Route('/health', name: 'health', methods: ['GET'])]
    public function health(): Response
    {
-        return new Response('{"status":"ok"}', 200, ['Content-Type' => 'application/json']);
-    }
+        $result     = $this->healthChecker->check();
+        $statusCode = $result['status'] === 'degraded' ? 503 : 200;

-    /** @return array<string, int> */
-    private function fetchAllContributions(): array
-    {
-        $contributions = [];
-
-        /** @var ProviderInterface $provider */
-        foreach ($this->providers as $provider) {
-            if (!$provider->isConfigured()) {
-                continue;
-            }
-
-            try {
-                $contributions = $this->merge($contributions, $provider->fetch());
-            } catch (\Throwable $e) {
-                $this->logger->warning(sprintf('%s fetch failed: %s', $provider::class, $e->getMessage()), ['exception' => $e]);
-            }
-        }
-
-        return $contributions;
-    }
-
-    /** @param array<string, int> $base @param array<string, int> $new @return array<string, int> */
-    private function merge(array $base, array $new): array
-    {
-        foreach ($new as $date => $count) {
-            $base[$date] = ($base[$date] ?? 0) + $count;
-        }
-
-        return $base;
+        return new Response(
+            json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR),
+            $statusCode,
+            ['Content-Type' => 'application/json'],
+        );
    }
 }
@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service;
+
+use App\Service\Provider\ProviderInterface;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
+
+final class ContributionAggregator
+{
+    public function __construct(
+        #[AutowireIterator('app.provider')]
+        private readonly iterable $providers,
+        private readonly LoggerInterface $logger,
+    ) {}
+
+    /** @return array<string, int> */
+    public function aggregate(): array
+    {
+        $pending = [];
+
+        /** @var ProviderInterface $provider */
+        foreach ($this->providers as $provider) {
+            if (!$provider->isConfigured()) {
+                continue;
+            }
+
+            try {
+                $pending[] = [$provider, $provider->startFetch()];
+            } catch (\Throwable $e) {
+                $this->logger->warning(sprintf('%s fetch failed: %s', $provider::class, $e->getMessage()), ['exception' => $e]);
+            }
+        }
+
+        $contributions = [];
+
+        foreach ($pending as [$provider, $handle]) {
+            try {
+                foreach ($provider->resolveFetch($handle) as $date => $count) {
+                    $contributions[$date] = ($contributions[$date] ?? 0) + $count;
+                }
+            } catch (\Throwable $e) {
+                $this->logger->warning(sprintf('%s fetch failed: %s', $provider::class, $e->getMessage()), ['exception' => $e]);
+            }
+        }
+
+        return $contributions;
+    }
+}
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service;
+
+use PDO;
+
+class ContributionStore {
+    private PDO $pdo;
+
+    public function __construct(
+        private readonly string $dbPath = "%kernel.project_dir%/var/data/contributions.db",
+        private readonly ?int $retentionDays = null,
+    ){
+        if(!is_dir(\dirname($this->dbPath))){
+            mkdir(\dirname($this->dbPath), 0755, recursive: true);
+        }
+        $this->pdo = new PDO('sqlite:' . $this->dbPath);
+        $this->pdo->setAttribute(PDO::ATTR_ERRMODE,PDO::ERRMODE_EXCEPTION);
+        $this->prepareSchema();
+    }
+
+    private function prepareSchema():void{
+        $this->pdo->exec('
+            CREATE TABLE IF NOT EXISTS contributions (
+                provider TEXT NOT NULL,
+                date     TEXT NOT NULL,
+                count    INTEGER NOT NULL CHECK (count >= 0),
+                PRIMARY KEY (provider, date)
+            ) WITHOUT ROWID, STRICT
+        ');
+    }
+    
+}
@@ -1,83 +0,0 @@
-<?php
-
-namespace App\Service;
-
-use Psr\Log\LoggerInterface;
-use Symfony\Contracts\HttpClient\HttpClientInterface;
-
-/**
- * Fetches the last 365 days of push/merge events from the GitLab REST API.
- *
- * Required token scopes: read_user, read_api
- * Works with both gitlab.com and self-hosted instances.
- */
-class GitLabProvider implements ProviderInterface
-{
-    public function __construct(
-        private readonly HttpClientInterface $client,
-        private readonly string $username,
-        private readonly string $token,
-        private readonly LoggerInterface $logger,
-        private readonly string $baseUrl = '',
-    ) {}
-
-    public function isConfigured(): bool
-    {
-        return $this->username !== '' && $this->token !== '';
-    }
-
-    /**
-     * @return array<string, int>  date (Y-m-d) => event count
-     */
-    public function fetch(): array
-    {
-        $baseUrl = rtrim($this->baseUrl !== '' ? $this->baseUrl : 'https://gitlab.com', '/');
-
-        $this->logger->debug('GitLabProvider: fetching contributions', ['user' => $this->username, 'url' => $baseUrl]);
-
-        // Resolve numeric user ID from username
-        $userResponse = $this->client->request('GET', "$baseUrl/api/v4/users", [
-            'headers' => ['PRIVATE-TOKEN' => $this->token],
-            'query'   => ['username' => $this->username],
-        ]);
-
-        $users = $userResponse->toArray();
-        if (empty($users)) {
-            throw new \RuntimeException("GitLab: user '{$this->username}' not found on $baseUrl");
-        }
-        $userId = $users[0]['id'];
-
-        $result = [];
-        $after  = (new \DateTimeImmutable('-365 days'))->format('Y-m-d');
-        $page   = 1;
-
-        do {
-            $response = $this->client->request('GET', "$baseUrl/api/v4/users/$userId/events", [
-                'headers' => ['PRIVATE-TOKEN' => $this->token],
-                'query'   => [
-                    'after'    => $after,
-                    'per_page' => 100,
-                    'page'     => $page,
-                ],
-            ]);
-
-            $events = $response->toArray();
-
-            foreach ($events as $event) {
-                $date          = substr($event['created_at'], 0, 10);
-                $result[$date] = ($result[$date] ?? 0) + 1;
-            }
-
-            $page++;
-        } while (count($events) === 100);
-
-        $this->logger->info('GitLabProvider: fetched contributions', [
-            'user'  => $this->username,
-            'pages' => $page - 1,
-            'days'  => count($result),
-            'total' => array_sum($result),
-        ]);
-
-        return $result;
-    }
-}
@@ -1,19 +1,25 @@
 <?php

-namespace App\Service;
+declare(strict_types=1);
+
+namespace App\Service\Provider;

 use IDCI\Bundle\GraphQLClientBundle\Client\GraphQLApiClient;
 use IDCI\Bundle\GraphQLClientBundle\Client\GraphQLApiClientRegistryInterface;
 use Psr\Log\LoggerInterface;
+use Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException;
 use Symfony\Contracts\HttpClient\HttpClientInterface;
+use Symfony\Contracts\HttpClient\ResponseInterface;

 /**
 * Fetches the last 365 days of contributions from the GitHub GraphQL API.
 *
 * Required token scopes: read:user
 */
-class GitHubProvider implements ProviderInterface
+final class GitHubProvider implements ProviderInterface
 {
+    use ProbeTrait;
+
    private const GRAPHQL_URL = 'https://api.github.com/graphql';

    public function __construct(
@@ -24,15 +30,24 @@ class GitHubProvider implements ProviderInterface
        private readonly LoggerInterface $logger,
    ) {}

+    public function getName(): string
+    {
+        return 'github';
+    }
+
    public function isConfigured(): bool
    {
        return $this->username !== '' && $this->token !== '';
    }

-    /**
-     * @return array<string, int>  date (Y-m-d) => contribution count
-     */
-    public function fetch(): array
+    public function ping(): void
+    {
+        $this->client->request('GET', 'https://api.github.com/user', [
+            'headers' => ['Authorization' => "Bearer {$this->token}"],
+        ])->getContent();
+    }
+
+    public function startFetch(): ResponseInterface
    {
        $this->logger->debug('GitHubProvider: fetching contributions', ['user' => $this->username]);

@@ -58,18 +73,27 @@ class GitHubProvider implements ProviderInterface

        // GitHub's GraphQL API requires application/json — the bundle's built-in
        // transport sends form_params, so we use Symfony HttpClient here instead.
-        $response = $this->client->request('POST', self::GRAPHQL_URL, [
+        // request() doesn't block; the response is read in resolveFetch() so
+        // multiple providers' requests can be in flight at once.
+        return $this->client->request('POST', self::GRAPHQL_URL, [
            'headers' => [
                'Authorization' => "Bearer {$this->token}",
                'Content-Type'  => 'application/json',
            ],
            'json' => ['query' => $query],
        ]);
+    }

-        $data = $response->toArray();
+    /**
+     * @return array<string, int>  date (Y-m-d) => contribution count
+     */
+    public function resolveFetch(mixed $handle): array
+    {
+        /** @var ResponseInterface $handle */
+        $data = $handle->toArray();

        if (isset($data['errors'])) {
-            throw new \RuntimeException('GitHub GraphQL error: ' . json_encode($data['errors']));
+            throw new ServiceUnavailableHttpException(null, 'GitHub GraphQL error: ' . json_encode($data['errors']));
        }

        $result = [];
@@ -0,0 +1,127 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service\Provider;
+
+use Psr\Log\LoggerInterface;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * Fetches the last 365 days of push/merge events from the GitLab REST API.
+ *
+ * Required token scopes: read_user, read_api
+ * Works with both gitlab.com and self-hosted instances.
+ */
+final class GitLabProvider implements ProviderInterface
+{
+    use ProbeTrait;
+
+    public function __construct(
+        private readonly HttpClientInterface $client,
+        private readonly string $username,
+        private readonly string $token,
+        private readonly LoggerInterface $logger,
+        private readonly string $baseUrl = '',
+    ) {
+        $this->baseUrl = rtrim($this->baseUrl !== '' ? $this->baseUrl : 'https://gitlab.com', '/');
+    }
+
+    public function getName(): string
+    {
+        return 'gitlab';
+    }
+
+    public function isConfigured(): bool
+    {
+        return $this->username !== '' && $this->token !== '';
+    }
+
+    public function ping(): void
+    {
+       
+        $this->client->request('GET', "$this->baseUrl/api/v4/user", [
+            'headers' => ['PRIVATE-TOKEN' => $this->token],
+        ])->getContent();
+    }
+
+    /**
+     * @return array{baseUrl: string, userId: int, after: string, page: int, response: ResponseInterface}
+     *
+     * ponytail: the user-id lookup and event pagination stay sequential within
+     * this one provider (each page depends on the previous). Parallelism here
+     * only spans across providers; revisit only if GitLab pagination itself
+     * becomes the bottleneck.
+     */
+    public function startFetch(): array
+    {
+        
+        $this->logger->debug('GitLabProvider: fetching contributions', ['user' => $this->username, 'url' => $this->baseUrl]);
+
+        $userResponse = $this->client->request('GET', "$this->baseUrl/api/v4/users", [
+            'headers' => ['PRIVATE-TOKEN' => $this->token],
+            'query'   => ['username' => $this->username],
+        ]);
+
+        $users = $userResponse->toArray();
+        if (empty($users)) {
+            throw new NotFoundHttpException("GitLab: user '{$this->username}' not found on $this->baseUrl");
+        }
+        $userId = $users[0]['id'];
+        $after  = (new \DateTimeImmutable('-365 days'))->format('Y-m-d');
+
+        $response = $this->client->request('GET', "$this->baseUrl/api/v4/users/$userId/events", [
+            'headers' => ['PRIVATE-TOKEN' => $this->token],
+            'query'   => [
+                'after'    => $after,
+                'per_page' => 100,
+                'page'     => 1,
+            ],
+        ]);
+
+        return ['baseUrl' => $this->baseUrl, 'userId' => $userId, 'after' => $after, 'page' => 1, 'response' => $response];
+    }
+
+    /**
+     * @return array<string, int>  date (Y-m-d) => event count
+     */
+    public function resolveFetch(mixed $handle): array
+    {
+        ['baseUrl' => $baseUrl, 'userId' => $userId, 'after' => $after, 'page' => $page, 'response' => $response] = $handle;
+
+        $result = [];
+
+        do {
+            $events = $response->toArray();
+
+            foreach ($events as $event) {
+                $date          = substr($event['created_at'], 0, 10);
+                $result[$date] = ($result[$date] ?? 0) + 1;
+            }
+
+            $page++;
+
+            if (count($events) === 100) {
+                $response = $this->client->request('GET', "$baseUrl/api/v4/users/$userId/events", [
+                    'headers' => ['PRIVATE-TOKEN' => $this->token],
+                    'query'   => [
+                        'after'    => $after,
+                        'per_page' => 100,
+                        'page'     => $page,
+                    ],
+                ]);
+            }
+        } while (count($events) === 100);
+
+        $this->logger->info('GitLabProvider: fetched contributions', [
+            'user'  => $this->username,
+            'pages' => $page - 1,
+            'days'  => count($result),
+            'total' => array_sum($result),
+        ]);
+
+        return $result;
+    }
+}
@@ -1,9 +1,12 @@
 <?php

-namespace App\Service;
+declare(strict_types=1);
+
+namespace App\Service\Provider;

 use Psr\Log\LoggerInterface;
 use Symfony\Contracts\HttpClient\HttpClientInterface;
+use Symfony\Contracts\HttpClient\ResponseInterface;

 /**
 * Fetches contribution data from the Gitea heatmap endpoint.
@@ -13,35 +16,57 @@ use Symfony\Contracts\HttpClient\HttpClientInterface;
 *
 * Required token scopes: read:user
 */
-class GiteaProvider implements ProviderInterface
+final class GiteaProvider implements ProviderInterface
 {
+    use ProbeTrait;
+
    public function __construct(
        private readonly HttpClientInterface $client,
        private readonly string $username,
        private readonly string $token,
        private readonly string $baseUrl,
        private readonly LoggerInterface $logger,
-    ) {}
+    ) {
+        $this->baseUrl = rtrim($this->baseUrl, '/');
+    }
+
+    public function getName(): string
+    {
+        return 'gitea';
+    }

    public function isConfigured(): bool
    {
        return $this->username !== '' && $this->token !== '' && $this->baseUrl !== '';
    }

+    public function ping(): void
+    {
+       
+
+        $this->client->request('GET', "$this->baseUrl/api/v1/user", [
+            'headers' => ['Authorization' => "token {$this->token}"],
+        ])->getContent();
+    }
+
+    public function startFetch(): ResponseInterface
+    {
+       
+
+        $this->logger->debug('GiteaProvider: fetching contributions', ['user' => $this->username, 'url' => $this->baseUrl]);
+
+        return $this->client->request('GET', "$this->baseUrl/api/v1/users/{$this->username}/heatmap", [
+            'headers' => ['Authorization' => "token {$this->token}"],
+        ]);
+    }
+
    /**
     * @return array<string, int>  date (Y-m-d) => contribution count
     */
-    public function fetch(): array
+    public function resolveFetch(mixed $handle): array
    {
-        $baseUrl  = rtrim($this->baseUrl, '/');
-
-        $this->logger->debug('GiteaProvider: fetching contributions', ['user' => $this->username, 'url' => $baseUrl]);
-
-        $response = $this->client->request('GET', "$baseUrl/api/v1/users/{$this->username}/heatmap", [
-            'headers' => ['Authorization' => "token {$this->token}"],
-        ]);
-
-        $data   = $response->toArray();
+        /** @var ResponseInterface $handle */
+        $data   = $handle->toArray();
        $cutoff = (new \DateTimeImmutable('-365 days'))->getTimestamp();
        $result = [];

@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service\Provider;
+
+use Symfony\Contracts\HttpClient\Exception\HttpExceptionInterface;
+use Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface;
+
+trait ProbeTrait
+{
+    public function probe(): ProviderStatus
+    {
+        if (!$this->isConfigured()) {
+            return new ProviderStatus($this->getName(), ProviderStatusType::NotConfigured);
+        }
+
+        try {
+            $this->ping();
+
+            return new ProviderStatus($this->getName(), ProviderStatusType::Ok);
+        } catch (\Throwable $e) {
+            return $this->statusFromException($e);
+        }
+    }
+
+    private function statusFromException(\Throwable $e): ProviderStatus
+    {
+        [$error, $message] = $this->classifyException($e);
+
+        return new ProviderStatus($this->getName(), ProviderStatusType::Error, $error, $message);
+    }
+
+    /** @return array{ProviderErrorCode, string} */
+    private function classifyException(\Throwable $e): array
+    {
+        if ($e instanceof TransportExceptionInterface) {
+            return [ProviderErrorCode::UrlUnreachable, 'Could not reach the server: ' . $e->getMessage()];
+        }
+
+        if ($e instanceof HttpExceptionInterface) {
+            $code = $e->getResponse()->getStatusCode();
+
+            return match (true) {
+                $code === 401 => [ProviderErrorCode::AuthFailed, 'Invalid or expired token — verify your credentials'],
+                $code === 403 => [ProviderErrorCode::AuthFailed, 'Access denied — token lacks the required scopes'],
+                $code === 404 => [ProviderErrorCode::UrlUnreachable, 'Endpoint not found — check the configured URL'],
+                default       => [ProviderErrorCode::Unknown, "HTTP {$code}: " . $e->getMessage()],
+            };
+        }
+
+        $msg   = $e->getMessage();
+        $lower = strtolower($msg);
+        $error = match (true) {
+            str_contains($msg, 'not found') || str_contains($msg, 'Could not resolve') => ProviderErrorCode::UserNotFound,
+            str_contains($msg, 'GraphQL error')
+                && (str_contains($lower, 'unauthorized') || str_contains($lower, 'bad credentials')) => ProviderErrorCode::AuthFailed,
+            default => ProviderErrorCode::Unknown,
+        };
+
+        return [$error, $msg];
+    }
+}
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service\Provider;
+
+enum ProviderErrorCode: string
+{
+    case AuthFailed     = 'auth_failed';
+    case UrlUnreachable = 'url_unreachable';
+    case UserNotFound   = 'user_not_found';
+    case Unknown        = 'unknown';
+}
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service\Provider;
+
+use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
+
+final class ProviderHealthChecker
+{
+    public function __construct(
+        #[AutowireIterator('app.provider')]
+        private readonly iterable $providers,
+    ) {}
+
+    /**
+     * @return array{status: string, providers: array<string, array<string, string>>}
+     */
+    public function check(): array
+    {
+        $statuses = [];
+        $hasError = false;
+
+        /** @var ProviderInterface $provider */
+        foreach ($this->providers as $provider) {
+            $status                  = $provider->probe();
+            $statuses[$status->name] = $status->toArray();
+
+            if ($status->status === ProviderStatusType::Error) {
+                $hasError = true;
+            }
+        }
+
+        return [
+            'status'    => $hasError ? 'degraded' : 'ok',
+            'providers' => $statuses,
+        ];
+    }
+}
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service\Provider;
+
+interface ProviderInterface
+{
+    /** Fire the HTTP request(s) without blocking; returns an opaque handle for resolveFetch(). */
+    public function startFetch(): mixed;
+
+    /** @return array<string, int>  date (Y-m-d) => contribution count */
+    public function resolveFetch(mixed $handle): array;
+
+    public function isConfigured(): bool;
+
+    public function getName(): string;
+
+    public function probe(): ProviderStatus;
+
+    public function ping(): void;
+}
@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service\Provider;
+
+final class ProviderStatus
+{
+    public function __construct(
+        public readonly string $name,
+        public readonly ProviderStatusType $status,
+        public readonly ?ProviderErrorCode $error = null,
+        public readonly ?string $message = null,
+    ) {}
+
+    /** @return array<string, string> */
+    public function toArray(): array
+    {
+        $data = ['status' => $this->status->value];
+        if ($this->error !== null) {
+            $data['error'] = $this->error->value;
+        }
+        if ($this->message !== null) {
+            $data['message'] = $this->message;
+        }
+
+        return $data;
+    }
+}
@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Service\Provider;
+
+enum ProviderStatusType: string
+{
+    case Ok            = 'ok';
+    case Error         = 'error';
+    case NotConfigured = 'not_configured';
+}
@@ -1,13 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Service;
-
-interface ProviderInterface
-{
-    /** @return array<string, int>  date (Y-m-d) => contribution count */
-    public function fetch(): array;
-
-    public function isConfigured(): bool;
-}
@@ -1,6 +1,8 @@
 <?php

-namespace App\Service;
+declare(strict_types=1);
+
+namespace App\Service\Renderer;

 /**
 * Renders a GitHub-style contribution heatmap as an inline SVG.
@@ -11,7 +13,7 @@ namespace App\Service;
 *  - Month labels above, weekday labels (Mon/Wed/Fri) on the left
 *  - 5 intensity levels (0–4) matched to GitHub's colour palette
 */
-class SvgRenderer
+final class SvgRenderer
 {
    // GitHub's exact colour tokens
    private const THEMES = [
@@ -0,0 +1,140 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Service;
+
+use App\Service\ContributionAggregator;
+use App\Service\Provider\ProviderInterface;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+use Psr\Log\LoggerInterface;
+
+#[CoversClass(ContributionAggregator::class)]
+final class ContributionAggregatorTest extends TestCase
+{
+    private LoggerInterface $logger;
+
+    protected function setUp(): void
+    {
+        $this->logger = $this->createStub(LoggerInterface::class);
+    }
+
+    #[Test]
+    public function it_returns_empty_array_when_no_providers_are_given(): void
+    {
+        $aggregator = new ContributionAggregator([], $this->logger);
+
+        $result = $aggregator->aggregate();
+
+        $this->assertSame([], $result);
+    }
+
+    #[Test]
+    public function it_skips_unconfigured_providers(): void
+    {
+        $provider = $this->createStub(ProviderInterface::class);
+        $provider->method('isConfigured')->willReturn(false);
+
+        $aggregator = new ContributionAggregator([$provider], $this->logger);
+
+        $result = $aggregator->aggregate();
+
+        $this->assertSame([], $result);
+    }
+
+    #[Test]
+    public function it_returns_contributions_from_a_configured_provider(): void
+    {
+        $provider = $this->createStub(ProviderInterface::class);
+        $provider->method('isConfigured')->willReturn(true);
+        $provider->method('resolveFetch')->willReturn(['2024-01-01' => 3]);
+
+        $aggregator = new ContributionAggregator([$provider], $this->logger);
+
+        $result = $aggregator->aggregate();
+
+        $this->assertSame(['2024-01-01' => 3], $result);
+    }
+
+    #[Test]
+    public function it_sums_contributions_from_multiple_providers_on_the_same_date(): void
+    {
+        $providerA = $this->createStub(ProviderInterface::class);
+        $providerA->method('isConfigured')->willReturn(true);
+        $providerA->method('resolveFetch')->willReturn(['2024-01-01' => 3, '2024-01-02' => 1]);
+
+        $providerB = $this->createStub(ProviderInterface::class);
+        $providerB->method('isConfigured')->willReturn(true);
+        $providerB->method('resolveFetch')->willReturn(['2024-01-01' => 2, '2024-01-03' => 5]);
+
+        $aggregator = new ContributionAggregator([$providerA, $providerB], $this->logger);
+
+        $result = $aggregator->aggregate();
+
+        $this->assertSame(['2024-01-01' => 5, '2024-01-02' => 1, '2024-01-03' => 5], $result);
+    }
+
+    #[Test]
+    public function it_continues_fetching_remaining_providers_when_one_throws_on_start(): void
+    {
+        $failing = $this->createStub(ProviderInterface::class);
+        $failing->method('isConfigured')->willReturn(true);
+        $failing->method('startFetch')->willThrowException(new \RuntimeException('Network error'));
+
+        $healthy = $this->createStub(ProviderInterface::class);
+        $healthy->method('isConfigured')->willReturn(true);
+        $healthy->method('resolveFetch')->willReturn(['2024-01-01' => 7]);
+
+        $aggregator = new ContributionAggregator([$failing, $healthy], $this->logger);
+
+        $result = $aggregator->aggregate();
+
+        $this->assertSame(['2024-01-01' => 7], $result);
+    }
+
+    #[Test]
+    public function it_continues_fetching_remaining_providers_when_one_throws_on_resolve(): void
+    {
+        $failing = $this->createStub(ProviderInterface::class);
+        $failing->method('isConfigured')->willReturn(true);
+        $failing->method('resolveFetch')->willThrowException(new \RuntimeException('Network error'));
+
+        $healthy = $this->createStub(ProviderInterface::class);
+        $healthy->method('isConfigured')->willReturn(true);
+        $healthy->method('resolveFetch')->willReturn(['2024-01-01' => 7]);
+
+        $aggregator = new ContributionAggregator([$failing, $healthy], $this->logger);
+
+        $result = $aggregator->aggregate();
+
+        $this->assertSame(['2024-01-01' => 7], $result);
+    }
+
+    #[Test]
+    public function it_logs_a_warning_when_a_provider_start_fetch_throws(): void
+    {
+        $logger = $this->createMock(LoggerInterface::class);
+        $logger->expects($this->once())->method('warning');
+
+        $provider = $this->createStub(ProviderInterface::class);
+        $provider->method('isConfigured')->willReturn(true);
+        $provider->method('startFetch')->willThrowException(new \RuntimeException('fail'));
+
+        (new ContributionAggregator([$provider], $logger))->aggregate();
+    }
+
+    #[Test]
+    public function it_logs_a_warning_when_a_provider_resolve_fetch_throws(): void
+    {
+        $logger = $this->createMock(LoggerInterface::class);
+        $logger->expects($this->once())->method('warning');
+
+        $provider = $this->createStub(ProviderInterface::class);
+        $provider->method('isConfigured')->willReturn(true);
+        $provider->method('resolveFetch')->willThrowException(new \RuntimeException('fail'));
+
+        (new ContributionAggregator([$provider], $logger))->aggregate();
+    }
+}
@@ -0,0 +1,150 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Service\Provider;
+
+use App\Service\Provider\GitHubProvider;
+use IDCI\Bundle\GraphQLClientBundle\Client\GraphQLApiClient;
+use IDCI\Bundle\GraphQLClientBundle\Client\GraphQLApiClientRegistryInterface;
+use IDCI\Bundle\GraphQLClientBundle\Query\GraphQLQuery;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+#[CoversClass(GitHubProvider::class)]
+final class GitHubProviderTest extends TestCase
+{
+    private function makeProvider(
+        string $username = 'user',
+        string $token = 'token',
+        ?HttpClientInterface $client = null,
+        ?GraphQLApiClientRegistryInterface $registry = null,
+    ): GitHubProvider {
+        if ($registry === null) {
+            $graphqlQuery = $this->createStub(GraphQLQuery::class);
+            $graphqlQuery->method('getGraphQLQuery')->willReturn('query {}');
+
+            $graphqlClient = $this->createStub(GraphQLApiClient::class);
+            $graphqlClient->method('buildQuery')->willReturn($graphqlQuery);
+
+            $registry = $this->createStub(GraphQLApiClientRegistryInterface::class);
+            $registry->method('get')->willReturn($graphqlClient);
+        }
+
+        return new GitHubProvider(
+            $client ?? $this->createStub(HttpClientInterface::class),
+            $registry,
+            $username,
+            $token,
+            $this->createStub(LoggerInterface::class),
+        );
+    }
+
+    private function stubGraphqlResponse(array $weeks): ResponseInterface
+    {
+        $response = $this->createStub(ResponseInterface::class);
+        $response->method('toArray')->willReturn([
+            'data' => [
+                'user' => [
+                    'contributionsCollection' => [
+                        'contributionCalendar' => ['weeks' => $weeks],
+                    ],
+                ],
+            ],
+        ]);
+
+        return $response;
+    }
+
+    #[Test]
+    public function it_returns_github_as_name(): void
+    {
+        $this->assertSame('github', $this->makeProvider()->getName());
+    }
+
+    #[Test]
+    public function it_is_configured_when_credentials_are_set(): void
+    {
+        $this->assertTrue($this->makeProvider()->isConfigured());
+    }
+
+    #[Test]
+    public function it_is_not_configured_when_username_is_empty(): void
+    {
+        $this->assertFalse($this->makeProvider(username: '')->isConfigured());
+    }
+
+    #[Test]
+    public function it_is_not_configured_when_token_is_empty(): void
+    {
+        $this->assertFalse($this->makeProvider(token: '')->isConfigured());
+    }
+
+    #[Test]
+    public function it_parses_contribution_days_from_the_graphql_response(): void
+    {
+        $client = $this->createStub(HttpClientInterface::class);
+        $client->method('request')->willReturn($this->stubGraphqlResponse([
+            ['contributionDays' => [
+                ['date' => '2024-06-10', 'contributionCount' => 4],
+                ['date' => '2024-06-11', 'contributionCount' => 2],
+            ]],
+        ]));
+
+        $provider = $this->makeProvider(client: $client);
+        $result = $provider->resolveFetch($provider->startFetch());
+
+        $this->assertSame(4, $result['2024-06-10']);
+        $this->assertSame(2, $result['2024-06-11']);
+    }
+
+    #[Test]
+    public function it_skips_days_with_zero_contributions(): void
+    {
+        $client = $this->createStub(HttpClientInterface::class);
+        $client->method('request')->willReturn($this->stubGraphqlResponse([
+            ['contributionDays' => [
+                ['date' => '2024-06-11', 'contributionCount' => 0],
+            ]],
+        ]));
+
+        $provider = $this->makeProvider(client: $client);
+        $result = $provider->resolveFetch($provider->startFetch());
+
+        $this->assertArrayNotHasKey('2024-06-11', $result);
+    }
+
+    #[Test]
+    public function it_throws_service_unavailable_exception_on_graphql_errors(): void
+    {
+        $response = $this->createStub(ResponseInterface::class);
+        $response->method('toArray')->willReturn([
+            'errors' => [['message' => 'Bad credentials']],
+        ]);
+
+        $client = $this->createStub(HttpClientInterface::class);
+        $client->method('request')->willReturn($response);
+
+        $this->expectException(ServiceUnavailableHttpException::class);
+
+        $provider = $this->makeProvider(client: $client);
+        $provider->resolveFetch($provider->startFetch());
+    }
+
+    #[Test]
+    public function it_returns_empty_when_response_has_no_weeks(): void
+    {
+        $client = $this->createStub(HttpClientInterface::class);
+        $client->method('request')->willReturn($this->stubGraphqlResponse([]));
+
+        $provider = $this->makeProvider(client: $client);
+        $result = $provider->resolveFetch($provider->startFetch());
+
+        $this->assertSame([], $result);
+    }
+}
@@ -0,0 +1,131 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Service\Provider;
+
+use App\Service\Provider\GitLabProvider;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+#[CoversClass(GitLabProvider::class)]
+final class GitLabProviderTest extends TestCase
+{
+    private function makeProvider(
+        string $username = 'user',
+        string $token = 'token',
+        string $baseUrl = '',
+        ?HttpClientInterface $client = null,
+    ): GitLabProvider {
+        return new GitLabProvider(
+            $client ?? $this->createStub(HttpClientInterface::class),
+            $username,
+            $token,
+            $this->createStub(LoggerInterface::class),
+            $baseUrl,
+        );
+    }
+
+    private function stubResponse(array $data): ResponseInterface
+    {
+        $response = $this->createStub(ResponseInterface::class);
+        $response->method('toArray')->willReturn($data);
+
+        return $response;
+    }
+
+    #[Test]
+    public function it_returns_gitlab_as_name(): void
+    {
+        $this->assertSame('gitlab', $this->makeProvider()->getName());
+    }
+
+    #[Test]
+    public function it_is_configured_when_credentials_are_set(): void
+    {
+        $this->assertTrue($this->makeProvider()->isConfigured());
+    }
+
+    #[Test]
+    public function it_is_not_configured_when_username_is_empty(): void
+    {
+        $this->assertFalse($this->makeProvider(username: '')->isConfigured());
+    }
+
+    #[Test]
+    public function it_is_not_configured_when_token_is_empty(): void
+    {
+        $this->assertFalse($this->makeProvider(token: '')->isConfigured());
+    }
+
+    #[Test]
+    public function it_throws_not_found_exception_when_user_does_not_exist(): void
+    {
+        $client = $this->createStub(HttpClientInterface::class);
+        $client->method('request')->willReturn($this->stubResponse([]));
+
+        $this->expectException(NotFoundHttpException::class);
+
+        $provider = $this->makeProvider(client: $client);
+        $provider->resolveFetch($provider->startFetch());
+    }
+
+    #[Test]
+    public function it_fetches_events_and_counts_them_by_date(): void
+    {
+        $client = $this->createMock(HttpClientInterface::class);
+        $client->method('request')->willReturnCallback(
+            function (string $method, string $url): ResponseInterface {
+                if (str_contains($url, '/events')) {
+                    return $this->stubResponse([
+                        ['created_at' => '2024-06-10T12:00:00.000Z'],
+                        ['created_at' => '2024-06-10T14:00:00.000Z'],
+                        ['created_at' => '2024-06-11T08:00:00.000Z'],
+                    ]);
+                }
+
+                return $this->stubResponse([['id' => 42]]);
+            }
+        );
+
+        $provider = $this->makeProvider(client: $client);
+        $result = $provider->resolveFetch($provider->startFetch());
+
+        $this->assertSame(2, $result['2024-06-10']);
+        $this->assertSame(1, $result['2024-06-11']);
+    }
+
+    #[Test]
+    public function it_fetches_multiple_pages_until_page_has_fewer_than_100_events(): void
+    {
+        $callCount = 0;
+
+        $client = $this->createMock(HttpClientInterface::class);
+        $client->method('request')->willReturnCallback(
+            function (string $method, string $url) use (&$callCount): ResponseInterface {
+                if (!str_contains($url, '/events')) {
+                    return $this->stubResponse([['id' => 42]]);
+                }
+
+                $callCount++;
+                $data = $callCount === 1
+                    ? array_fill(0, 100, ['created_at' => '2024-06-10T12:00:00.000Z'])
+                    : [['created_at' => '2024-06-11T08:00:00.000Z']];
+
+                return $this->stubResponse($data);
+            }
+        );
+
+        $provider = $this->makeProvider(client: $client);
+        $result = $provider->resolveFetch($provider->startFetch());
+
+        $this->assertSame(2, $callCount);
+        $this->assertSame(100, $result['2024-06-10']);
+        $this->assertSame(1, $result['2024-06-11']);
+    }
+}
@@ -0,0 +1,114 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Service\Provider;
+
+use App\Service\Provider\GiteaProvider;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+use Psr\Log\LoggerInterface;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+#[CoversClass(GiteaProvider::class)]
+final class GiteaProviderTest extends TestCase
+{
+    private function makeProvider(
+        string $username = 'user',
+        string $token = 'token',
+        string $baseUrl = 'https://gitea.example.com',
+        ?HttpClientInterface $client = null,
+    ): GiteaProvider {
+        return new GiteaProvider(
+            $client ?? $this->createStub(HttpClientInterface::class),
+            $username,
+            $token,
+            $baseUrl,
+            $this->createStub(LoggerInterface::class),
+        );
+    }
+
+    private function stubResponse(array $data): ResponseInterface
+    {
+        $response = $this->createStub(ResponseInterface::class);
+        $response->method('toArray')->willReturn($data);
+
+        return $response;
+    }
+
+    #[Test]
+    public function it_returns_gitea_as_name(): void
+    {
+        $this->assertSame('gitea', $this->makeProvider()->getName());
+    }
+
+    #[Test]
+    public function it_is_configured_when_all_credentials_are_set(): void
+    {
+        $this->assertTrue($this->makeProvider()->isConfigured());
+    }
+
+    #[Test]
+    public function it_is_not_configured_when_username_is_empty(): void
+    {
+        $this->assertFalse($this->makeProvider(username: '')->isConfigured());
+    }
+
+    #[Test]
+    public function it_is_not_configured_when_token_is_empty(): void
+    {
+        $this->assertFalse($this->makeProvider(token: '')->isConfigured());
+    }
+
+    #[Test]
+    public function it_is_not_configured_when_base_url_is_empty(): void
+    {
+        $this->assertFalse($this->makeProvider(baseUrl: '')->isConfigured());
+    }
+
+    #[Test]
+    public function it_parses_heatmap_entries_into_contributions(): void
+    {
+        $now = time();
+
+        $client = $this->createStub(HttpClientInterface::class);
+        $client->method('request')->willReturn($this->stubResponse([
+            ['timestamp' => $now, 'contributions' => 5],
+        ]));
+
+        $provider = $this->makeProvider(client: $client);
+        $result = $provider->resolveFetch($provider->startFetch());
+
+        $this->assertSame(5, $result[date('Y-m-d', $now)]);
+    }
+
+    #[Test]
+    public function it_filters_out_entries_older_than_365_days(): void
+    {
+        $old = (new \DateTimeImmutable('-366 days'))->getTimestamp();
+
+        $client = $this->createStub(HttpClientInterface::class);
+        $client->method('request')->willReturn($this->stubResponse([
+            ['timestamp' => $old, 'contributions' => 3],
+        ]));
+
+        $provider = $this->makeProvider(client: $client);
+        $result = $provider->resolveFetch($provider->startFetch());
+
+        $this->assertSame([], $result);
+    }
+
+    #[Test]
+    public function it_returns_empty_when_response_has_no_entries(): void
+    {
+        $client = $this->createStub(HttpClientInterface::class);
+        $client->method('request')->willReturn($this->stubResponse([]));
+
+        $provider = $this->makeProvider(client: $client);
+        $result = $provider->resolveFetch($provider->startFetch());
+
+        $this->assertSame([], $result);
+    }
+}
@@ -0,0 +1,129 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Service\Provider;
+
+use App\Service\Provider\ProbeTrait;
+use App\Service\Provider\ProviderErrorCode;
+use App\Service\Provider\ProviderInterface;
+use App\Service\Provider\ProviderStatusType;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;
+use Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+#[CoversClass(ProbeTrait::class)]
+final class ProbeTraitTest extends TestCase
+{
+    private function makeProvider(bool $configured, \Closure $ping): ProviderInterface
+    {
+        return new class($configured, $ping) implements ProviderInterface {
+            use ProbeTrait;
+
+            public function __construct(
+                private bool $configured,
+                private \Closure $ping,
+            ) {}
+
+            public function isConfigured(): bool { return $this->configured; }
+            public function getName(): string { return 'test'; }
+            public function ping(): void { ($this->ping)(); }
+            public function startFetch(): mixed { return null; }
+            public function resolveFetch(mixed $handle): array { return []; }
+        };
+    }
+
+    #[Test]
+    public function it_returns_not_configured_when_provider_is_not_configured(): void
+    {
+        $provider = $this->makeProvider(false, fn() => null);
+
+        $status = $provider->probe();
+
+        $this->assertSame(ProviderStatusType::NotConfigured, $status->status);
+        $this->assertNull($status->error);
+    }
+
+    #[Test]
+    public function it_returns_ok_when_ping_succeeds(): void
+    {
+        $provider = $this->makeProvider(true, fn() => null);
+
+        $status = $provider->probe();
+
+        $this->assertSame(ProviderStatusType::Ok, $status->status);
+        $this->assertNull($status->error);
+    }
+
+    #[Test]
+    public function it_returns_url_unreachable_on_transport_failure(): void
+    {
+        $exception = $this->createStub(TransportExceptionInterface::class);
+        $provider  = $this->makeProvider(true, fn() => throw $exception);
+
+        $status = $provider->probe();
+
+        $this->assertSame(ProviderStatusType::Error, $status->status);
+        $this->assertSame(ProviderErrorCode::UrlUnreachable, $status->error);
+    }
+
+    #[Test]
+    public function it_returns_auth_failed_on_401(): void
+    {
+        $response = $this->createStub(ResponseInterface::class);
+        $response->method('getStatusCode')->willReturn(401);
+
+        $exception = $this->createStub(ClientExceptionInterface::class);
+        $exception->method('getResponse')->willReturn($response);
+
+        $status = $this->makeProvider(true, fn() => throw $exception)->probe();
+
+        $this->assertSame(ProviderStatusType::Error, $status->status);
+        $this->assertSame(ProviderErrorCode::AuthFailed, $status->error);
+    }
+
+    #[Test]
+    public function it_returns_auth_failed_on_403(): void
+    {
+        $response = $this->createStub(ResponseInterface::class);
+        $response->method('getStatusCode')->willReturn(403);
+
+        $exception = $this->createStub(ClientExceptionInterface::class);
+        $exception->method('getResponse')->willReturn($response);
+
+        $status = $this->makeProvider(true, fn() => throw $exception)->probe();
+
+        $this->assertSame(ProviderStatusType::Error, $status->status);
+        $this->assertSame(ProviderErrorCode::AuthFailed, $status->error);
+    }
+
+    #[Test]
+    public function it_returns_url_unreachable_on_404(): void
+    {
+        $response = $this->createStub(ResponseInterface::class);
+        $response->method('getStatusCode')->willReturn(404);
+
+        $exception = $this->createStub(ClientExceptionInterface::class);
+        $exception->method('getResponse')->willReturn($response);
+
+        $status = $this->makeProvider(true, fn() => throw $exception)->probe();
+
+        $this->assertSame(ProviderStatusType::Error, $status->status);
+        $this->assertSame(ProviderErrorCode::UrlUnreachable, $status->error);
+    }
+
+    #[Test]
+    public function it_returns_unknown_error_on_unexpected_exception(): void
+    {
+        $provider = $this->makeProvider(true, fn() => throw new \RuntimeException('Something went wrong'));
+
+        $status = $provider->probe();
+
+        $this->assertSame(ProviderStatusType::Error, $status->status);
+        $this->assertSame(ProviderErrorCode::Unknown, $status->error);
+        $this->assertSame('Something went wrong', $status->message);
+    }
+}
@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Service\Provider;
+
+use App\Service\Provider\ProviderErrorCode;
+use App\Service\Provider\ProviderHealthChecker;
+use App\Service\Provider\ProviderInterface;
+use App\Service\Provider\ProviderStatus;
+use App\Service\Provider\ProviderStatusType;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(ProviderHealthChecker::class)]
+final class ProviderHealthCheckerTest extends TestCase
+{
+    #[Test]
+    public function it_returns_ok_when_all_providers_are_healthy(): void
+    {
+        $provider = $this->createStub(ProviderInterface::class);
+        $provider->method('probe')->willReturn(new ProviderStatus('test', ProviderStatusType::Ok));
+
+        $result = (new ProviderHealthChecker([$provider]))->check();
+
+        $this->assertSame('ok', $result['status']);
+    }
+
+    #[Test]
+    public function it_returns_degraded_when_a_provider_has_an_error(): void
+    {
+        $provider = $this->createStub(ProviderInterface::class);
+        $provider->method('probe')->willReturn(
+            new ProviderStatus('test', ProviderStatusType::Error, ProviderErrorCode::AuthFailed, 'Invalid token'),
+        );
+
+        $result = (new ProviderHealthChecker([$provider]))->check();
+
+        $this->assertSame('degraded', $result['status']);
+    }
+
+    #[Test]
+    public function it_does_not_degrade_when_a_provider_is_not_configured(): void
+    {
+        $provider = $this->createStub(ProviderInterface::class);
+        $provider->method('probe')->willReturn(new ProviderStatus('test', ProviderStatusType::NotConfigured));
+
+        $result = (new ProviderHealthChecker([$provider]))->check();
+
+        $this->assertSame('ok', $result['status']);
+    }
+
+    #[Test]
+    public function it_indexes_provider_statuses_by_name(): void
+    {
+        $provider = $this->createStub(ProviderInterface::class);
+        $provider->method('probe')->willReturn(new ProviderStatus('github', ProviderStatusType::Ok));
+
+        $result = (new ProviderHealthChecker([$provider]))->check();
+
+        $this->assertArrayHasKey('github', $result['providers']);
+    }
+
+    #[Test]
+    public function it_returns_ok_with_no_providers(): void
+    {
+        $result = (new ProviderHealthChecker([]))->check();
+
+        $this->assertSame('ok', $result['status']);
+        $this->assertSame([], $result['providers']);
+    }
+
+    #[Test]
+    public function it_includes_all_provider_statuses_in_output(): void
+    {
+        $github = $this->createStub(ProviderInterface::class);
+        $github->method('probe')->willReturn(new ProviderStatus('github', ProviderStatusType::Ok));
+
+        $gitlab = $this->createStub(ProviderInterface::class);
+        $gitlab->method('probe')->willReturn(new ProviderStatus('gitlab', ProviderStatusType::NotConfigured));
+
+        $result = (new ProviderHealthChecker([$github, $gitlab]))->check();
+
+        $this->assertArrayHasKey('github', $result['providers']);
+        $this->assertArrayHasKey('gitlab', $result['providers']);
+    }
+}
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Service\Provider;
+
+use App\Service\Provider\ProviderErrorCode;
+use App\Service\Provider\ProviderStatus;
+use App\Service\Provider\ProviderStatusType;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(ProviderStatus::class)]
+final class ProviderStatusTest extends TestCase
+{
+    #[Test]
+    public function it_serializes_ok_status(): void
+    {
+        $status = new ProviderStatus('github', ProviderStatusType::Ok);
+
+        $this->assertSame(['status' => 'ok'], $status->toArray());
+    }
+
+    #[Test]
+    public function it_serializes_not_configured_status(): void
+    {
+        $status = new ProviderStatus('github', ProviderStatusType::NotConfigured);
+
+        $this->assertSame(['status' => 'not_configured'], $status->toArray());
+    }
+
+    #[Test]
+    public function it_serializes_error_status_with_code_and_message(): void
+    {
+        $status = new ProviderStatus('github', ProviderStatusType::Error, ProviderErrorCode::AuthFailed, 'Token expired');
+
+        $this->assertSame([
+            'status'  => 'error',
+            'error'   => 'auth_failed',
+            'message' => 'Token expired',
+        ], $status->toArray());
+    }
+
+    #[Test]
+    public function it_omits_null_error_fields_from_array(): void
+    {
+        $status = new ProviderStatus('github', ProviderStatusType::Ok);
+
+        $array = $status->toArray();
+
+        $this->assertArrayNotHasKey('error', $array);
+        $this->assertArrayNotHasKey('message', $array);
+    }
+
+    #[Test]
+    public function it_exposes_typed_status_property(): void
+    {
+        $status = new ProviderStatus('github', ProviderStatusType::Error, ProviderErrorCode::Unknown, 'msg');
+
+        $this->assertSame(ProviderStatusType::Error, $status->status);
+        $this->assertSame(ProviderErrorCode::Unknown, $status->error);
+    }
+}
@@ -0,0 +1,133 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Service\Renderer;
+
+use App\Service\Renderer\SvgRenderer;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(SvgRenderer::class)]
+final class SvgRendererTest extends TestCase
+{
+    #[Test]
+    public function it_returns_an_svg_opening_tag(): void
+    {
+        $svg = (new SvgRenderer())->render([]);
+
+        $this->assertStringStartsWith('<svg', $svg);
+    }
+
+    #[Test]
+    public function it_returns_a_closed_svg_element(): void
+    {
+        $svg = (new SvgRenderer())->render([]);
+
+        $this->assertStringEndsWith('</svg>', $svg);
+    }
+
+    #[Test]
+    public function it_includes_role_img_attribute_for_accessibility(): void
+    {
+        $svg = (new SvgRenderer())->render([]);
+
+        $this->assertStringContainsString('role="img"', $svg);
+    }
+
+    #[Test]
+    public function it_includes_aria_label_attribute_for_accessibility(): void
+    {
+        $svg = (new SvgRenderer())->render([]);
+
+        $this->assertStringContainsString('aria-label="Contribution graph"', $svg);
+    }
+
+    #[Test]
+    #[DataProvider('theme_background_provider')]
+    public function it_applies_background_color_for_theme(string $theme, string $expectedColor): void
+    {
+        $svg = (new SvgRenderer())->render([], $theme);
+
+        $this->assertStringContainsString($expectedColor, $svg);
+    }
+
+    public static function theme_background_provider(): iterable
+    {
+        yield 'dark theme'    => ['dark',    '#0d1117'];
+        yield 'light theme'   => ['light',   '#ffffff'];
+        yield 'unknown theme' => ['unknown', '#0d1117'];
+    }
+
+    #[Test]
+    public function it_shows_zero_contributions_when_no_data_is_provided(): void
+    {
+        $svg = (new SvgRenderer())->render([]);
+
+        $this->assertStringContainsString('0 contributions in the last year', $svg);
+    }
+
+    #[Test]
+    public function it_displays_formatted_total_contribution_count(): void
+    {
+        $today = (new \DateTimeImmutable('today'))->format('Y-m-d');
+
+        $svg = (new SvgRenderer())->render([$today => 1234]);
+
+        $this->assertStringContainsString('1,234 contributions in the last year', $svg);
+    }
+
+    #[Test]
+    public function it_renders_all_53_week_columns(): void
+    {
+        $svg = (new SvgRenderer())->render([]);
+
+        // MARGIN_X(28) + col_52 * STEP(13) = 704
+        $this->assertStringContainsString('x="704"', $svg);
+    }
+
+    #[Test]
+    #[DataProvider('day_of_week_label_provider')]
+    public function it_renders_day_of_week_label(string $label): void
+    {
+        $svg = (new SvgRenderer())->render([]);
+
+        $this->assertStringContainsString('>' . $label . '<', $svg);
+    }
+
+    public static function day_of_week_label_provider(): iterable
+    {
+        yield 'Monday'    => ['Mon'];
+        yield 'Wednesday' => ['Wed'];
+        yield 'Friday'    => ['Fri'];
+    }
+
+    #[Test]
+    public function it_renders_a_less_label_in_the_legend(): void
+    {
+        $svg = (new SvgRenderer())->render([]);
+
+        $this->assertStringContainsString('>Less<', $svg);
+    }
+
+    #[Test]
+    public function it_renders_a_more_label_in_the_legend(): void
+    {
+        $svg = (new SvgRenderer())->render([]);
+
+        $this->assertStringContainsString('>More<', $svg);
+    }
+
+    #[Test]
+    public function it_sums_contributions_from_multiple_dates(): void
+    {
+        $today     = (new \DateTimeImmutable('today'))->format('Y-m-d');
+        $yesterday = (new \DateTimeImmutable('yesterday'))->format('Y-m-d');
+
+        $svg = (new SvgRenderer())->render([$today => 3, $yesterday => 7]);
+
+        $this->assertStringContainsString('10 contributions in the last year', $svg);
+    }
+}
@@ -1,120 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace App\Tests\Unit\Service;
-
-use App\Service\SvgRenderer;
-use PHPUnit\Framework\Attributes\CoversClass;
-use PHPUnit\Framework\Attributes\Test;
-use PHPUnit\Framework\TestCase;
-
-#[CoversClass(SvgRenderer::class)]
-final class SvgRendererTest extends TestCase
-{
-    private SvgRenderer $renderer;
-
-    protected function setUp(): void
-    {
-        $this->renderer = new SvgRenderer();
-    }
-
-    #[Test]
-    public function it_returns_a_valid_svg_element(): void
-    {
-        $svg = $this->renderer->render([]);
-
-        $this->assertStringStartsWith('<svg', $svg);
-        $this->assertStringEndsWith('</svg>', $svg);
-    }
-
-    #[Test]
-    public function it_includes_accessibility_attributes(): void
-    {
-        $svg = $this->renderer->render([]);
-
-        $this->assertStringContainsString('role="img"', $svg);
-        $this->assertStringContainsString('aria-label="Contribution graph"', $svg);
-    }
-
-    #[Test]
-    public function it_applies_dark_theme_background_color(): void
-    {
-        $svg = $this->renderer->render([], 'dark');
-
-        $this->assertStringContainsString('#0d1117', $svg);
-    }
-
-    #[Test]
-    public function it_applies_light_theme_background_color(): void
-    {
-        $svg = $this->renderer->render([], 'light');
-
-        $this->assertStringContainsString('#ffffff', $svg);
-    }
-
-    #[Test]
-    public function it_falls_back_to_dark_theme_for_unknown_theme_names(): void
-    {
-        $svg = $this->renderer->render([], 'unknown');
-
-        $this->assertStringContainsString('#0d1117', $svg);
-    }
-
-    #[Test]
-    public function it_shows_zero_contributions_when_no_data_is_provided(): void
-    {
-        $svg = $this->renderer->render([]);
-
-        $this->assertStringContainsString('0 contributions in the last year', $svg);
-    }
-
-    #[Test]
-    public function it_displays_formatted_total_contribution_count(): void
-    {
-        $today = (new \DateTimeImmutable('today'))->format('Y-m-d');
-
-        $svg = $this->renderer->render([$today => 1234]);
-
-        $this->assertStringContainsString('1,234 contributions in the last year', $svg);
-    }
-
-    #[Test]
-    public function it_renders_all_53_week_columns(): void
-    {
-        $svg = $this->renderer->render([]);
-
-        // MARGIN_X(28) + col_52 * STEP(13) = 704
-        $this->assertStringContainsString('x="704"', $svg);
-    }
-
-    #[Test]
-    public function it_renders_day_of_week_labels_matching_github(): void
-    {
-        $svg = $this->renderer->render([]);
-
-        $this->assertStringContainsString('>Mon<', $svg);
-        $this->assertStringContainsString('>Wed<', $svg);
-        $this->assertStringContainsString('>Fri<', $svg);
-    }
-
-    #[Test]
-    public function it_renders_a_legend_with_less_and_more_labels(): void
-    {
-        $svg = $this->renderer->render([]);
-
-        $this->assertStringContainsString('>Less<', $svg);
-        $this->assertStringContainsString('>More<', $svg);
-    }
-
-    #[Test]
-    public function it_sums_contributions_from_multiple_dates(): void
-    {
-        $today     = (new \DateTimeImmutable('today'))->format('Y-m-d');
-        $yesterday = (new \DateTimeImmutable('yesterday'))->format('Y-m-d');
-
-        $svg = $this->renderer->render([$today => 3, $yesterday => 7]);
-
-        $this->assertStringContainsString('10 contributions in the last year', $svg);
-    }
-}
Author	SHA1	Message	Date
haylan	3d2c0487b7	feat(store): fist stepts for implement ContributionStore for managing contributions in SQLite	2026-07-08 06:50:56 +02:00
haylan	cb89a1c6b9	chore(docker): update volume mappings for development environment	2026-07-08 06:50:39 +02:00
haylan	5e27a5bc93	fix(provider): dedoupet base URL is properly formatted in GitLab and Gitea providers	2026-07-08 06:50:25 +02:00
haylan	f52a3449c6	chore(TODO): mark completed tasks and update contribution store details	2026-07-08 06:49:28 +02:00
haylan	ca94b80beb	chore(composer): remove deprecated Guzzle and GraphQL client configurations	2026-07-08 06:49:18 +02:00
haylan	cd326a34ba	chore(controller): lower set_time_limit now that fetching is concurrent Providers fetch in parallel now (cost ~= max, not sum), so the old 90s stopgap for the 3-sequential-providers-plus-pagination worst case can come back down toward the 30s default, with headroom for pagination and per-request HTTP timeouts.	2026-07-07 13:32:17 +02:00
haylan	8fb7781227	test(aggregator): cover concurrent fetch failure modes Mocks startFetch()/resolveFetch() instead of fetch(), and splits the old single failure test into separate start-throws and resolve-throws cases since those are now distinct call sites.	2026-07-07 13:32:11 +02:00
haylan	1e2f022579	test(gitlab): exercise startFetch()/resolveFetch() instead of fetch()	2026-07-07 13:32:05 +02:00
haylan	c89b4e9212	test(gitea): exercise startFetch()/resolveFetch() instead of fetch()	2026-07-07 13:31:59 +02:00
haylan	5c47888a49	test(github): exercise startFetch()/resolveFetch() instead of fetch()	2026-07-07 13:31:52 +02:00
haylan	f2bf24994c	test(provider): update ProbeTraitTest stub for split fetch API The anonymous ProviderInterface implementation needs startFetch()/ resolveFetch() instead of fetch() to stay loadable.	2026-07-07 13:31:44 +02:00
haylan	fcf841f7ad	feat(aggregator): fetch all providers concurrently aggregate() now fires every configured provider's startFetch() in one pass before resolving any of them, so wall-clock cost is roughly max(providers) instead of sum(providers). Partial-failure isolation and per-date summation behavior are unchanged.	2026-07-07 13:31:36 +02:00
haylan	9b631f4777	refactor(gitlab): make GitLabProvider fetch non-blocking startFetch() resolves the user id and fires the first events page, returning a handle without reading it; resolveFetch() continues the existing do/while pagination starting from that first response. Pagination itself stays sequential within this provider since each page depends on the previous one - parallelism here only spans across providers, not within GitLab's own pages.	2026-07-07 13:31:30 +02:00
haylan	596260bb85	refactor(gitea): make GiteaProvider fetch non-blocking startFetch() fires the heatmap GET and returns the response without reading it; resolveFetch() does the .toArray()/parse/log work.	2026-07-07 13:31:21 +02:00
haylan	9f3c54afd1	refactor(github): make GitHubProvider fetch non-blocking startFetch() fires the GraphQL POST and returns the response without reading it; resolveFetch() does the .toArray()/parse/log work that used to happen inline right after the request.	2026-07-07 13:31:15 +02:00
haylan	11bec43bbe	refactor(provider): split fetch() into startFetch()/resolveFetch() Splits the provider contract into a non-blocking startFetch() that fires the HTTP request(s) and a resolveFetch() that reads the result, so callers can fire every provider's request before blocking on any of them. Symfony HttpClient is already async under the hood - request() doesn't block until you read the response - so this needs no new dependency.	2026-07-07 13:31:09 +02:00
haylan	09c0be8312	config: cap http_client timeout and max_duration Per-request bounds so a single slow/hung provider can't stall the whole request indefinitely once fetching happens concurrently.	2026-07-07 13:31:03 +02:00
haylan	6d6680ca37	fix(di): correct provider service FQCNs in services.yaml Providers were moved into the App\Service\Provider namespace, but services.yaml still tagged/configured them under the old App\Service FQCNs, so the _instanceof conditional never matched and the container failed to compile.	2026-07-07 13:30:57 +02:00
haylan	406da07397	chore(todod): proposal plane for sotaged the history	2026-07-02 07:30:01 +02:00
haylan	d5d948f423	Merge pull request 'chore(deps): update dependency eightpoints/guzzle-bundle to v8.7.0' (#11 ) from renovate/eightpoints-guzzle-bundle-8.x-lockfile into main Reviewed-on: #11	2026-06-23 17:14:32 +00:00
renovate-bot	a6e904fc61	chore(deps): update dependency eightpoints/guzzle-bundle to v8.7.0	2026-06-23 12:01:52 +00:00
haylan	980463f715	Merge pull request 'Update renovate.json' (#10 ) from change-renovate-configuration into main Reviewed-on: #10	2026-06-04 00:44:33 +02:00
haylan	095b9675f9	Update renovate.json	2026-06-04 00:44:18 +02:00
haylan	8dbfef8496	Merge pull request 'refactor: reorgeniced Service/ into Provider/ and Renderer/ sub-namespaces' (#9 ) from refactor/service-namespaces into main Reviewed-on: #9	2026-06-04 00:42:43 +02:00
haylan	a527eada56	Merge pull request 'feat: add contribution graph favicon (ICO + PNG)' (#8 ) from feat/favicon into main Reviewed-on: #8	2026-06-04 00:42:37 +02:00
haylan	423ac5470d	Merge branch 'main' into refactor/service-namespaces	2026-06-04 00:42:28 +02:00
haylan	4e992c8f79	Merge branch 'main' into feat/favicon	2026-06-04 00:42:11 +02:00
haylan	4983492088	Merge pull request 'chore(config): migrate Renovate config' (#7 ) from renovate/migrate-config into main Reviewed-on: #7	2026-06-04 00:31:09 +02:00
renovate-bot	169fa8c76a	chore(config): migrate config renovate.json	2026-06-03 22:29:25 +00:00
haylan	4cefba1a37	Merge pull request 'chore: Configure Renovate' (#5 ) from renovate/configure into main Reviewed-on: #5	2026-06-03 10:42:26 +02:00
haylan	28a0916487	chore(renovate): pinned shymfony version, seperated major and minor. removed major upgrades	2026-06-03 10:37:49 +02:00
renovate-bot	4cfa61f1c0	Add renovate.json	2026-06-03 08:27:12 +00:00
haylanandClaude Sonnet 4.6	2f3268c0b7	refactor: reorganise Service/ into Provider/ and Renderer/ sub-namespaces Move all provider-related classes, enums, interface and trait into App\Service\Provider; move SvgRenderer into App\Service\Renderer. ContributionAggregator stays at the Service root as the orchestrator. Test namespaces and use statements updated to match. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-31 00:10:09 +02:00
haylanandClaude Sonnet 4.6	89d0e2b0f6	feat: add contribution graph favicon (ICO + PNG) Multi-size favicon.ico (16×16, 32×32, 48×48) and favicon.png built from a 5×5 GitHub-green contribution graph grid on a dark #0d1117 background. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-31 00:00:06 +02:00
haylan	fad176419c	Merge pull request 'Fix/docker production' (#4 ) from fix/docker-production into main Reviewed-on: #4	2026-05-30 23:43:06 +02:00
haylan	3743ba31d2	Merge branch 'main' into fix/docker-production	2026-05-30 23:42:57 +02:00
haylan	8a675cf02f	fix: aligen docker image with symfyon stu	2026-05-30 17:28:59 +02:00
haylan	20c5acc5ae	Merge pull request 'Update README.md' (#3 ) from haylan-patch-1 into main Reviewed-on: #3	2026-05-30 16:51:50 +02:00
haylan	21867256e8	Update README.md	2026-05-30 16:51:42 +02:00
haylan	67d4a50ee1	chroe: removed test	2026-05-30 16:29:31 +02:00
haylan	e72ee2541e	fix: fixed build stages and docker images. Docker image is now sleeker. The pulbish build should now have less garbage	2026-05-30 16:14:51 +02:00
haylanandClaude Sonnet 4.6	ecdb8c1716	fix(docker): commit composer.lock and install intl extension - Remove composer.lock from .gitignore so it is tracked and included in the build context; without it composer install resolves fresh versions on every CI build, causing cache/vendor mismatches that produce the RewindableGenerator and LazyGhostTrait runtime errors in prod - Install the intl PHP extension in the base stage to remove the Symfony startup deprecation warning; icu-dev and libzip-dev are only kept for the compile step, then deleted to keep the layer lean Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 15:41:17 +02:00
haylan	841f4329de	feat: removed patters x.x and x	2026-05-30 15:29:46 +02:00
haylanandClaude Sonnet 4.6	50256c97ef	build(docker): warm prod cache at build time and add prod compose file - Run cache:warmup in the build stage so containers start with a pre-built Symfony kernel and DI container - Scope the cache volume to var/cache/prod/pools where Symfony writes pool data, preserving the warmed kernel across container restarts - Add docker-compose.prod.yml for deploying the registry image without the dev override being picked up automatically - Expand .dockerignore to exclude vendor/, tests/, docs, compose files, and env files from the build context Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 15:15:51 +02:00
haylan	2f66c65b30	Merge pull request 'feat: FrankenPHP runtime, per-provider health probes, and ContributionAggregator' (#2 ) from feat/frankenphp into main Reviewed-on: #2	2026-05-30 14:32:10 +02:00
haylanandClaude Sonnet 4.6	38312f549c	docs: add CHANGELOG for 0.1.0 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 14:27:58 +02:00
haylanandClaude Sonnet 4.6	a8d5f205db	docs: fix typos and reformat tables in CLAUDE.md Fix "Prever" typo, add Windows WSL test runner command, and align Markdown table columns for readability. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 14:14:38 +02:00
haylanandClaude Sonnet 4.6	85428826a0	test(provider): add unit tests for probe infrastructure and all providers Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 14:14:06 +02:00
haylanandClaude Sonnet 4.6	61b7735afc	refactor(renderer): add strict_types declaration and make class final Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 14:13:51 +02:00
haylanandClaude Sonnet 4.6	c70d96c3aa	feat(health): make /health report per-provider probe status Introduce ProviderHealthChecker which probes each configured provider via AutowireIterator. Wire it into GraphController so /health returns detailed per-provider status and responds 503 when any provider is in a degraded state. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 14:13:24 +02:00
haylanandClaude Sonnet 4.6	d3b9463c57	feat(provider): implement ping and probe on GitHub, GitLab, and Gitea Add getName() and ping() to each provider and wire ProbeTrait. Make all classes final, add strict_types declarations, and replace generic RuntimeException with typed HTTP exceptions so probe() can classify auth failures and unreachable endpoints correctly. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 14:13:14 +02:00
haylanandClaude Sonnet 4.6	71bfb38028	feat(provider): add health-probe contract and supporting value objects Add getName(), ping(), and probe() to ProviderInterface. Introduce ProbeTrait to classify HTTP/transport exceptions into typed error codes, ProviderStatus as the result value object, and ProviderStatusType / ProviderErrorCode as backing enums. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 14:13:07 +02:00
haylanandClaude Sonnet 4.6	225c614057	test(service): refactor SvgRendererTest to follow PHPUnit best practices - Replace setUp() factory with direct instantiation (zero-param constructor) - Add AAA blank-line separators to all test methods - Consolidate theme + fallback tests behind a DataProvider - Consolidate day-of-week label tests behind a DataProvider - Split multi-assertion tests to one assertion per test Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 12:58:23 +02:00
haylanandClaude Sonnet 4.6	c205fed14b	refactor(controller): extract contribution aggregation into dedicated service Move fetchAllContributions and merge logic from GraphController into a new ContributionAggregator service. Replace deprecated TaggedIterator with AutowireIterator throughout. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 12:58:17 +02:00
haylanandClaude Sonnet 4.6	3e3a6752af	chore(dev): remove broken auto-run PHPUnit hook The PostToolUse hook called php bin/phpunit directly, which does not work inside the Docker-based dev setup. Remove it; tests should be run via docker compose exec graph vendor/bin/phpunit as documented. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 12:39:39 +02:00
haylanandClaude Sonnet 4.6	5b07eae672	docs: update installation guide to use pre-built image Replace the clone-and-build workflow with a docker-compose snippet that pulls the image directly from the Gitea container registry. Add semver tag reference and rename steps to match the new flow. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 12:39:33 +02:00
haylanandClaude Sonnet 4.6	235e63bfc0	fix(config): add default empty values for optional env vars Declare empty-string defaults for all optional env vars as Symfony parameters so the container compiles without errors when GITHUB_USER, GITLAB_TOKEN, GITEA_URL, etc. are not set in the environment. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 12:39:29 +02:00
haylanandClaude Sonnet 4.6	92380e534a	feat(docker): migrate base image from php-cli to FrankenPHP Alpine Replace php:8.4-cli-alpine3.21 with dunglas/frankenphp:1-php8.4-alpine. No Go toolchain required — the official image ships as a pre-compiled Alpine binary. - Drop docker-php-ext-install opcache (FrankenPHP enables it by default) - Both dev and final stages run frankenphp run --config /etc/caddy/Caddyfile - Dev stage bakes in Caddyfile.dev (no worker mode, Xdebug compatible) - Final stage bakes in production Caddyfile Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 12:38:38 +02:00
haylanandClaude Sonnet 4.6	4654a287a8	feat(app): add FrankenPHP worker script for Symfony Boot the Symfony kernel once at startup, then loop with frankenphp_handle_request() to handle every incoming request without re-bootstrapping the framework. Supports MAX_REQUESTS env var for graceful worker restarts. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 12:38:27 +02:00
haylanandClaude Sonnet 4.6	2427c07f4c	feat(docker): add FrankenPHP Caddy configuration Add production and dev Caddyfiles for FrankenPHP: - Caddyfile: HTTP-only on :8080, auto_https off, worker mode - Caddyfile.dev: same but without worker directive so Xdebug step-debugging remains functional; Caddy debug logging enabled Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-30 12:38:23 +02:00
haylan	7c1b893e09	chore: update docker image to php 8.4	2026-05-29 23:20:53 +02:00
haylan	4993fdca00	Update .env	2026-05-29 23:04:39 +02:00
haylan	c4803ea5cb	fix: fixed labeling to make contaienr apper correctly in the repo	2026-05-29 22:43:53 +02:00
haylan	19bfa4cf28	Update README.md	2026-05-29 22:37:25 +02:00
haylan	e70d035672	feat: change to use token	2026-05-29 19:42:10 +02:00
haylan	d57320cb77	fix: changed pipline to use workflow token instead self made one	2026-05-29 19:32:36 +02:00
haylan	5feae97dd3	feat: fix manuel pipline. to create a release tag or replace exisiting release	2026-05-29 19:20:32 +02:00