chore: rename phlex → phlix

.gitignore

@@ -4,3 +4,4 @@
 /coverage-report/
 /coverage.xml
 /build/
+.caliber/

AGENTS.md

@@ -1,6 +1,6 @@
-# AGENTS.md — detain/phlex-shared
+# AGENTS.md — detain/phlix-shared
 
-Agent brief for the `phlex-shared` package. This package is **pure
+Agent brief for the `phlix-shared` package. This package is **pure
 interfaces and value objects**. Keep it that way.
 
 ## Conventions
@@ -9,8 +9,8 @@ interfaces and value objects**. Keep it that way.
   first-class callable syntax, etc.) where they aid clarity.
 - **`declare(strict_types=1);`** at the top of every PHP file.
 - **PSR-12** coding standard, enforced by phpcs.
-- **PSR-4 autoload** — `Phlex\Shared\` → `src/`,
-  `Phlex\Shared\Tests\` → `tests/`. Namespaces mirror directories.
+- **PSR-4 autoload** — `Phlix\Shared\` → `src/`,
+  `Phlix\Shared\Tests\` → `tests/`. Namespaces mirror directories.
 - **Static analysis bar:** PHPStan level 9 and Psalm errorLevel 1, both
   green from day 1. No baselines.
 - **Zero I/O.** No filesystem reads, no network, no DB, no logging
@@ -28,11 +28,11 @@ interfaces and value objects**. Keep it that way.
 
 ```
 src/
-  Plugin/    # Phlex\Shared\Plugin\* — lifecycle, manifest, types
-  Events/    # Phlex\Shared\Events\* — event name constants & DTOs
-  Auth/      # Phlex\Shared\Auth\* — token, identity, claim types
-  Hub/       # Phlex\Shared\Hub\* — phlex ↔ phlex-hub protocol types
-  Arr/       # Phlex\Shared\Arr\* — typed array helpers (PHPStan-friendly)
+  Plugin/    # Phlix\Shared\Plugin\* — lifecycle, manifest, types
+  Events/    # Phlix\Shared\Events\* — event name constants & DTOs
+  Auth/      # Phlix\Shared\Auth\* — token, identity, claim types
+  Hub/       # Phlix\Shared\Hub\* — phlix ↔ phlix-hub protocol types
+  Arr/       # Phlix\Shared\Arr\* — typed array helpers (PHPStan-friendly)
   Version.php
 tests/
   (mirror of src/ — PHPUnit 10)
@@ -44,10 +44,10 @@ Subdirectories materialise as B.3 lands real interfaces.
 ## Layout rationale
 
 See `plans/expansion/b.1-shared-design.md` in
-[`detain/phlex`](https://github.com/detain/phlex) for the full WHAT
+[`detain/phlix`](https://github.com/detain/phlix) for the full WHAT
 MOVES WHERE table and the design rationale for the namespace split.
 Do not re-litigate that design here — propose changes in a new plan
-step against `detain/phlex` if needed.
+step against `detain/phlix` if needed.
 
 ## Before committing
 
@@ -64,5 +64,5 @@ If any tool emits warnings, fix the code — do not add to a baseline.
 ## Versioning
 
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Bump the
-`Phlex\Shared\Version::VERSION` constant in lockstep with the git tag
+`Phlix\Shared\Version::VERSION` constant in lockstep with the git tag
 and the `CHANGELOG.md` heading.

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-All notable changes to `detain/phlex-shared` are documented here.
+All notable changes to `detain/phlix-shared` are documented here.
 
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
@@ -9,53 +9,53 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 ## [0.4.0] — 2026-05-18
 
 ### Added
-- `Phlex\Shared\Arr\ArrClientInterface` — common interface for Sonarr/Radarr
+- `Phlix\Shared\Arr\ArrClientInterface` — common interface for Sonarr/Radarr
   HTTP clients (queue, quality profiles, tags, test-connection).
-- `Phlex\Shared\Arr\ArrClientFactory` — factory that instantiates Sonarr/Radarr
+- `Phlix\Shared\Arr\ArrClientFactory` — factory that instantiates Sonarr/Radarr
   clients from instance config arrays.
-- `Phlex\Shared\Arr\SyncResult` — immutable value object returned by sync flows.
-- `Phlex\Shared\Arr\SonarrClient` — typed Sonarr v3 HTTP client.
-- `Phlex\Shared\Arr\RadarrClient` — typed Radarr v3 HTTP client.
-- `Phlex\Shared\Arr\BazarrClient` — typed Bazarr HTTP client.
-- `Phlex\Shared\Arr\ProwlarrClient` — typed Prowlarr HTTP client.
-- `Phlex\Shared\Arr\TrashGuidesProvider` — fetches TRaSH-Guides quality
+- `Phlix\Shared\Arr\SyncResult` — immutable value object returned by sync flows.
+- `Phlix\Shared\Arr\SonarrClient` — typed Sonarr v3 HTTP client.
+- `Phlix\Shared\Arr\RadarrClient` — typed Radarr v3 HTTP client.
+- `Phlix\Shared\Arr\BazarrClient` — typed Bazarr HTTP client.
+- `Phlix\Shared\Arr\ProwlarrClient` — typed Prowlarr HTTP client.
+- `Phlix\Shared\Arr\TrashGuidesProvider` — fetches TRaSH-Guides quality
   profile + custom format JSON.
 - `psr/log` runtime dependency to allow optional PSR-3 loggers on the arr
-  clients without pulling phlex-server's concrete `StructuredLogger`.
+  clients without pulling phlix-server's concrete `StructuredLogger`.
 
 ### Changed
-- Arr classes now type-hint `Psr\Log\LoggerInterface` instead of phlex-server's
+- Arr classes now type-hint `Psr\Log\LoggerInterface` instead of phlix-server's
   `StructuredLogger`, allowing the hub and any other PSR-3 consumer to inject
   its own logger. Required for Step K.1 (arr clients shared between
-  phlex-server and phlex-hub) and K.3 (hub-side request fulfillment).
+  phlix-server and phlix-hub) and K.3 (hub-side request fulfillment).
 
 ## [0.3.0] — 2026-05-17
 
 ### Added
-- `Phlex\Shared\Auth\ProviderInterface` — core interface for pluggable external
+- `Phlix\Shared\Auth\ProviderInterface` — core interface for pluggable external
   authentication providers (OIDC, LDAP, SAML, passkeys). Zero I/O dependencies
-  so both phlex-server and phlex-hub can implement providers without pulling in
+  so both phlix-server and phlix-hub can implement providers without pulling in
   server/runtime dependencies.
-- `Phlex\Shared\Auth\AuthResult` — immutable value object returned by
+- `Phlix\Shared\Auth\AuthResult` — immutable value object returned by
   `ProviderInterface::authenticate()`. Captures success/failure, local userId,
   provider externalId, error code, and arbitrary attributes (email, name,
   avatarUrl …).
-- `Phlex\Shared\Auth\UserInfo` — immutable value object returned by
+- `Phlix\Shared\Auth\UserInfo` — immutable value object returned by
   `ProviderInterface::getUserInfo()`. Describes an external identity for
   account linking and profile display.
 
 ## [0.2.0] — 2026-05-17
 
 ### Added
-- `Phlex\Shared\Plugin\LifecycleInterface` — moved from `Phlex\Plugins\Contract\LifecycleInterface` in `phlex-server`.
-- `Phlex\Shared\Plugin\{Manifest,ManifestType,ManifestValidationError,EventNameMap}` — moved from `Phlex\Plugins\*` in `phlex-server`. Validator logic stays in `phlex-server` (`Phlex\Plugins\Manifest\ManifestSchema`).
-- `Phlex\Shared\Events\{AbstractEvent, Playback\*, Library\*, Auth\*}` — moved from `Phlex\Common\Events\*` in `phlex-server` (the 12 readonly event DTOs). PSR-14 dispatcher wiring stays in `phlex-server`.
-- `Phlex\Shared\Auth\JwtClaims` — new value object capturing the Phlex JWT payload shape; consumed by `phlex-hub` starting Phase C.5.
-- `Phlex\Shared\Hub\{ClaimRequest,ClaimResponse,ServerInfoDto,HeartbeatDto}` — new placeholder DTOs for the hub claim/heartbeat protocol; consumed by `phlex-hub` starting Phase C.1.
-- `Phlex\Shared\Arr\.gitkeep` — namespace reserved for Phase K.1's `Sonarr`/`Radarr`/etc. typed clients.
+- `Phlix\Shared\Plugin\LifecycleInterface` — moved from `Phlix\Plugins\Contract\LifecycleInterface` in `phlix-server`.
+- `Phlix\Shared\Plugin\{Manifest,ManifestType,ManifestValidationError,EventNameMap}` — moved from `Phlix\Plugins\*` in `phlix-server`. Validator logic stays in `phlix-server` (`Phlix\Plugins\Manifest\ManifestSchema`).
+- `Phlix\Shared\Events\{AbstractEvent, Playback\*, Library\*, Auth\*}` — moved from `Phlix\Common\Events\*` in `phlix-server` (the 12 readonly event DTOs). PSR-14 dispatcher wiring stays in `phlix-server`.
+- `Phlix\Shared\Auth\JwtClaims` — new value object capturing the Phlix JWT payload shape; consumed by `phlix-hub` starting Phase C.5.
+- `Phlix\Shared\Hub\{ClaimRequest,ClaimResponse,ServerInfoDto,HeartbeatDto}` — new placeholder DTOs for the hub claim/heartbeat protocol; consumed by `phlix-hub` starting Phase C.1.
+- `Phlix\Shared\Arr\.gitkeep` — namespace reserved for Phase K.1's `Sonarr`/`Radarr`/etc. typed clients.
 
 ## [0.1.0] — 2026-05-17
 
 ### Added
-- Initial release: composer package scaffolding, `Phlex\Shared\Version` marker class, CI workflow.
-- Real interfaces and DTOs land in v0.2.0 per `plans/expansion/b.1-shared-design.md` in `detain/phlex`.
+- Initial release: composer package scaffolding, `Phlix\Shared\Version` marker class, CI workflow.
+- Real interfaces and DTOs land in v0.2.0 per `plans/expansion/b.1-shared-design.md` in `detain/phlix`.

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Joe Huss / Phlex Project
+Copyright (c) 2026 Joe Huss / Phlix Project
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,22 +1,22 @@
-# detain/phlex-shared
+# detain/phlix-shared
 
 Shared interfaces, DTOs, event names, and protocol types used by both
-[`detain/phlex-server`](https://github.com/detain/phlex) (the media server)
-and `detain/phlex-hub` (the multi-server hub, forthcoming). Composer-installable,
+[`detain/phlix-server`](https://github.com/detain/phlix) (the media server)
+and `detain/phlix-hub` (the multi-server hub, forthcoming). Composer-installable,
 PHP 8.3+, zero I/O — pure interfaces and value objects only.
 
 ## Status
 
 **v0.2.0 — Plugin / Events / Auth / Hub namespaces.** Shipped:
 
-- `Phlex\Shared\Plugin\{LifecycleInterface, Manifest, ManifestType, ManifestValidationError, EventNameMap}`
-- `Phlex\Shared\Events\{AbstractEvent, Playback\*, Library\*, Auth\*}` — 12 event DTOs.
-- `Phlex\Shared\Auth\JwtClaims`
-- `Phlex\Shared\Hub\{ClaimRequest, ClaimResponse, ServerInfoDto, HeartbeatDto}`
-- `Phlex\Shared\Arr\` — namespace reserved for Phase K.1.
+- `Phlix\Shared\Plugin\{LifecycleInterface, Manifest, ManifestType, ManifestValidationError, EventNameMap}`
+- `Phlix\Shared\Events\{AbstractEvent, Playback\*, Library\*, Auth\*}` — 12 event DTOs.
+- `Phlix\Shared\Auth\JwtClaims`
+- `Phlix\Shared\Hub\{ClaimRequest, ClaimResponse, ServerInfoDto, HeartbeatDto}`
+- `Phlix\Shared\Arr\` — namespace reserved for Phase K.1.
 
 The PSR-14 dispatcher wiring (Tukio) and the manifest JSON-Schema
-validator stay in `phlex-server` and consume this package via Composer.
+validator stay in `phlix-server` and consume this package via Composer.
 
 ## Requirements
 
@@ -30,33 +30,33 @@ no Smarty. It is intended to be safely required by any PHP 8.3+ codebase.
 
 ## Installation
 
-Until `detain/phlex-shared` is published to Packagist (planned post-v1.0),
+Until `detain/phlix-shared` is published to Packagist (planned post-v1.0),
 consumers require it via a Composer VCS repository entry:
 
 ```json
 {
     "repositories": [
         {
             "type": "vcs",
-            "url": "git@github.com:detain/phlex-shared.git"
+            "url": "git@github.com:detain/phlix-shared.git"
         }
     ],
     "require": {
-        "detain/phlex-shared": "^0.2"
+        "detain/phlix-shared": "^0.2"
     }
 }
 ```
 
 Then:
 
 ```bash
-composer update detain/phlex-shared
+composer update detain/phlix-shared
 ```
 
 ## Related repositories
 
-- [`detain/phlex`](https://github.com/detain/phlex) — the Phlex media server (consumes this package from B.3 onward).
-- `detain/phlex-hub` — the multi-server hub (forthcoming, B.5+).
+- [`detain/phlix`](https://github.com/detain/phlix) — the Phlix media server (consumes this package from B.3 onward).
+- `detain/phlix-hub` — the multi-server hub (forthcoming, B.5+).
 
 ## Development
 

composer.json

@@ -1,6 +1,6 @@
 {
-    "name": "detain/phlex-shared",
-    "description": "Shared interfaces, DTOs, event names, and protocol types used by both phlex-server and phlex-hub. Composer-installable, PHP 8.3+, zero I/O.",
+    "name": "detain/phlix-shared",
+    "description": "Shared interfaces, DTOs, event names, and protocol types used by both phlix-server and phlix-hub. Composer-installable, PHP 8.3+, zero I/O.",
     "type": "library",
     "license": "MIT",
     "require": {
@@ -18,12 +18,12 @@
     },
     "autoload": {
         "psr-4": {
-            "Phlex\\Shared\\": "src/"
+            "Phlix\\Shared\\": "src/"
         }
     },
     "autoload-dev": {
         "psr-4": {
-            "Phlex\\Shared\\Tests\\": "tests/"
+            "Phlix\\Shared\\Tests\\": "tests/"
         }
     },
     "minimum-stability": "stable",

phpcs.xml.dist

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<ruleset name="phlex-shared">
-    <description>PSR-12 coding standard for detain/phlex-shared.</description>
+<ruleset name="phlix-shared">
+    <description>PSR-12 coding standard for detain/phlix-shared.</description>
 
     <file>src</file>
 

src/Arr/ArrClientFactory.php

@@ -2,14 +2,14 @@
 
 declare(strict_types=1);
 
-namespace Phlex\Shared\Arr;
+namespace Phlix\Shared\Arr;
 
 use Psr\Log\LoggerInterface;
 
 /**
  * Factory for creating Sonarr/Radarr API clients from config.
  *
- * @package Phlex\Shared\Arr
+ * @package Phlix\Shared\Arr
  * @since 0.12.0
  */
 class ArrClientFactory

src/Arr/ArrClientInterface.php

@@ -2,12 +2,12 @@
 
 declare(strict_types=1);
 
-namespace Phlex\Shared\Arr;
+namespace Phlix\Shared\Arr;
 
 /**
  * Common interface for Sonarr/Radarr API clients.
  *
- * @package Phlex\Shared\Arr
+ * @package Phlix\Shared\Arr
  * @since 0.12.0
  */
 interface ArrClientInterface

src/Arr/BazarrClient.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace Phlex\Shared\Arr;
+namespace Phlix\Shared\Arr;
 
 use Psr\Log\LoggerInterface;
 use RuntimeException;
 
 /**
  * Bazarr API client for subtitle management.
  *
- * @package Phlex\Shared\Arr
+ * @package Phlix\Shared\Arr
  * @since 0.12.0
  */
 class BazarrClient
@@ -75,7 +75,7 @@
      *
      * @param string $videoFilePath The full path to the video file.
      * @param string $languageCode The language code for the subtitle (e.g. `en`, `es`, `pt-BR`).
      * @return array<string, mixed> Download result.
      */
     public function downloadSubtitle(string $videoFilePath, string $languageCode): array
     {
@@ -84,7 +84,7 @@
             'language' => $languageCode,
         ];
 
         return $this->post('/api/v1/subtitles/download', $payload);
     }
 
     /**
@@ -140,7 +140,7 @@
 
         /** @var string|false */
         $responseBody = curl_exec($ch);
         $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
         $curlErrno = curl_errno($ch);
         $curlError = curl_error($ch);
         curl_close($ch);
@@ -158,12 +158,12 @@
         }
 
         if ($httpCode >= 400) {
             throw new RuntimeException('Bazarr API error: HTTP ' . $httpCode);
         }
 
         /** @var array<mixed, mixed> */
         $decoded = json_decode($responseBody, true);
         if (!is_array($decoded)) {
             throw new RuntimeException('Invalid JSON response from Bazarr');
         }
 
@@ -204,7 +204,7 @@
 
         /** @var string|false */
         $responseBody = curl_exec($ch);
         $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
         $curlErrno = curl_errno($ch);
         $curlError = curl_error($ch);
         curl_close($ch);
@@ -222,7 +222,7 @@
         }
 
         if ($httpCode >= 400) {
             throw new RuntimeException('Bazarr API error: HTTP ' . $httpCode);
         }
 
         if ($responseBody === '') {
@@ -231,7 +231,7 @@
 
         /** @var array<mixed, mixed> */
         $decoded = json_decode($responseBody, true);
         if (!is_array($decoded)) {
             throw new RuntimeException('Invalid JSON response from Bazarr');
         }
 

src/Arr/ProwlarrClient.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace Phlex\Shared\Arr;
+namespace Phlix\Shared\Arr;
 
 use Psr\Log\LoggerInterface;
 use RuntimeException;
 
 /**
  * Prowlarr API client for indexer management.
  *
- * @package Phlex\Shared\Arr
+ * @package Phlix\Shared\Arr
  * @since 0.12.0
  */
 class ProwlarrClient
@@ -55,11 +55,11 @@
      * Returns statistics for a specific indexer.
      *
      * @param int $indexerId The indexer ID.
      * @return array<string, mixed> Indexer stats.
      */
     public function getIndexerStats(int $indexerId): array
     {
         return $this->get('/api/v1/indexer/' . $indexerId);
     }
 
     /**

src/Arr/RadarrClient.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace Phlex\Shared\Arr;
+namespace Phlix\Shared\Arr;
 
 use Psr\Log\LoggerInterface;
 use RuntimeException;
 
 /**
  * Radarr v3 API client for movie management.
  *
- * @package Phlex\Shared\Arr
+ * @package Phlix\Shared\Arr
  * @since 0.12.0
  */
 class RadarrClient implements ArrClientInterface

src/Arr/SonarrClient.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace Phlex\Shared\Arr;
+namespace Phlix\Shared\Arr;
 
 use Psr\Log\LoggerInterface;
 use RuntimeException;
 
 /**
  * Sonarr v3 API client for TV series management.
  *
- * @package Phlex\Shared\Arr
+ * @package Phlix\Shared\Arr
  * @since 0.12.0
  */
 class SonarrClient implements ArrClientInterface

src/Arr/SyncResult.php

@@ -2,14 +2,14 @@
 
 declare(strict_types=1);
 
-namespace Phlex\Shared\Arr;
+namespace Phlix\Shared\Arr;
 
 use DateTimeImmutable;
 
 /**
  * Value object representing the result of a TRaSH-Guides sync operation.
  *
- * @package Phlex\Shared\Arr
+ * @package Phlix\Shared\Arr
  * @since 0.12.0
  */
 class SyncResult