From 53984de60d9a2535f0f9f63bfc70e839311dcc8b Mon Sep 17 00:00:00 2001
From: Ali Hesari <alihesarim@gmail.com>
Date: Sat, 7 Mar 2026 18:13:24 +0100
Subject: [PATCH] fix: add PHPCS inline directives for WordPress Plugin Check
 compatibility
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Added phpcs:disable comments to all source, example, and test files
so the library passes WordPress coding standards when bundled as a
vendor dependency inside WordPress plugins.

No functional code changes — only inline PHPCS comment directives.
---
 CHANGELOG.md                                        | 13 +++++++++++++
 composer.json                                       |  9 +++++++--
 examples/mock/01_creating_posts.php                 |  1 +
 examples/mock/02_media_handling.php                 |  1 +
 examples/mock/03_formatting.php                     |  1 +
 examples/mock/04_platform_config.php                |  1 +
 examples/mock/05_platform_registry.php              |  1 +
 examples/mock/06_publishing.php                     |  1 +
 examples/mock/07_error_handling.php                 |  1 +
 examples/mock/08_events.php                         |  1 +
 examples/mock/09_support_utilities.php              |  1 +
 examples/mock/10_auth_oauth.php                     |  1 +
 examples/mock/11_delivery_status.php                |  1 +
 examples/mock/12_full_workflow.php                  |  1 +
 examples/mock/platform_discord.php                  |  1 +
 examples/mock/platform_instagram.php                |  1 +
 examples/mock/platform_pinterest.php                |  1 +
 examples/mock/platform_reddit.php                   |  1 +
 examples/mock/platform_slack.php                    |  1 +
 examples/mock/platform_tumblr.php                   |  1 +
 examples/mock/platform_whatsapp.php                 |  1 +
 examples/real/helpers.php                           |  1 +
 examples/real/platform_discord.php                  |  1 +
 examples/real/platform_facebook.php                 |  1 +
 examples/real/platform_instagram.php                |  1 +
 examples/real/platform_linkedin.php                 |  1 +
 examples/real/platform_pinterest.php                |  1 +
 examples/real/platform_reddit.php                   |  1 +
 examples/real/platform_slack.php                    |  1 +
 examples/real/platform_telegram.php                 |  1 +
 examples/real/platform_tumblr.php                   |  1 +
 examples/real/platform_twitter.php                  |  1 +
 examples/real/platform_whatsapp.php                 |  1 +
 src/Auth/OAuthHandler.php                           |  2 ++
 src/Config/ConfigValidator.php                      |  2 ++
 src/Config/PlatformCredentials.php                  |  2 ++
 src/Http/HttpClient.php                             |  4 ++++
 src/Platforms/Discord/DiscordPlatform.php           |  2 ++
 src/Platforms/Facebook/FacebookPlatform.php         |  3 +++
 src/Platforms/Instagram/InstagramPlatform.php       |  4 ++++
 src/Platforms/LinkedIn/LinkedInPlatform.php         |  4 ++++
 src/Platforms/Pinterest/PinterestPlatform.php       |  3 +++
 src/Platforms/PlatformRegistry.php                  |  2 ++
 src/Platforms/Reddit/RedditPlatform.php             |  2 ++
 src/Platforms/Slack/SlackPlatform.php               |  3 +++
 src/Platforms/Telegram/TelegramPlatform.php         |  4 ++++
 src/Platforms/Tumblr/TumblrPlatform.php             |  3 +++
 src/Platforms/Twitter/TwitterPlatform.php           |  4 ++++
 src/Platforms/WhatsApp/WhatsAppPlatform.php         |  3 +++
 .../Unit/Platforms/Discord/DiscordFormatterTest.php |  1 +
 .../Unit/Platforms/Discord/DiscordPlatformTest.php  |  1 +
 .../Platforms/Facebook/FacebookFormatterTest.php    |  1 +
 .../Platforms/Facebook/FacebookPlatformTest.php     |  1 +
 .../Platforms/Instagram/InstagramFormatterTest.php  |  1 +
 .../Platforms/Instagram/InstagramPlatformTest.php   |  1 +
 .../Platforms/LinkedIn/LinkedInFormatterTest.php    |  1 +
 .../Platforms/LinkedIn/LinkedInPlatformTest.php     |  1 +
 .../Platforms/Pinterest/PinterestFormatterTest.php  |  1 +
 .../Platforms/Pinterest/PinterestPlatformTest.php   |  1 +
 tests/Unit/Platforms/Reddit/RedditFormatterTest.php |  1 +
 tests/Unit/Platforms/Reddit/RedditPlatformTest.php  |  1 +
 tests/Unit/Platforms/Slack/SlackFormatterTest.php   |  1 +
 tests/Unit/Platforms/Slack/SlackPlatformTest.php    |  1 +
 .../Platforms/Telegram/TelegramFormatterTest.php    |  1 +
 .../Platforms/Telegram/TelegramPlatformTest.php     |  1 +
 tests/Unit/Platforms/Tumblr/TumblrFormatterTest.php |  1 +
 tests/Unit/Platforms/Tumblr/TumblrPlatformTest.php  |  1 +
 .../Unit/Platforms/Twitter/TwitterFormatterTest.php |  1 +
 .../Unit/Platforms/Twitter/TwitterPlatformTest.php  |  1 +
 .../Platforms/WhatsApp/WhatsAppFormatterTest.php    |  1 +
 .../Platforms/WhatsApp/WhatsAppPlatformTest.php     |  1 +
 71 files changed, 120 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f3b161a..61c9865 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.1] - 2025-07-25
+
+### Fixed
+- Added PHPCS inline directives (`phpcs:disable`) to all source, example, and test files for WordPress Plugin Check compatibility
+- Framework-agnostic library files now pass WordPress coding standards when bundled as a vendor dependency in WordPress plugins
+- Suppressed `WordPress.Security.EscapeOutput.ExceptionNotEscaped` — exceptions are not WordPress output in this library
+- Suppressed `WordPress.WP.AlternativeFunctions` — native PHP functions (cURL, json_encode, file_get_contents) are required for framework independence
+- Suppressed `WordPress.PHP.DiscouragedPHPFunctions` — base64_encode/urlencode required for OAuth and API operations
+- Suppressed `WordPress.PHP.NoSilencedErrors` — @unlink used for temporary file cleanup in HttpClient
+- Suppressed `Universal.Operators.DisallowShortTernary` — short ternary intentionally used for concise null/empty handling
+
+## [1.0.0]
+
 ### Added
 - Framework-agnostic PHP core for social media publishing
 - Platform abstractions with `PlatformInterface` and `PlatformResponseInterface`
diff --git a/composer.json b/composer.json
index b8a5fbe..d5d49be 100644
--- a/composer.json
+++ b/composer.json
@@ -27,7 +27,9 @@
         "ext-json": "*"
     },
     "require-dev": {
-        "phpunit/phpunit": "^10.0|^11.0"
+        "dealerdirect/phpcodesniffer-composer-installer": "^1.2",
+        "phpunit/phpunit": "^10.0|^11.0",
+        "wp-coding-standards/wpcs": "^3.3"
     },
     "autoload": {
         "psr-4": {
@@ -42,6 +44,9 @@
     "minimum-stability": "stable",
     "prefer-stable": true,
     "config": {
-        "sort-packages": true
+        "sort-packages": true,
+        "allow-plugins": {
+            "dealerdirect/phpcodesniffer-composer-installer": true
+        }
     }
 }
diff --git a/examples/mock/01_creating_posts.php b/examples/mock/01_creating_posts.php
index 4eed302..42fcf1b 100644
--- a/examples/mock/01_creating_posts.php
+++ b/examples/mock/01_creating_posts.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/02_media_handling.php b/examples/mock/02_media_handling.php
index 0c51258..87be854 100644
--- a/examples/mock/02_media_handling.php
+++ b/examples/mock/02_media_handling.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/03_formatting.php b/examples/mock/03_formatting.php
index 68d6516..fed70ae 100644
--- a/examples/mock/03_formatting.php
+++ b/examples/mock/03_formatting.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/04_platform_config.php b/examples/mock/04_platform_config.php
index 515236c..d21b8e0 100644
--- a/examples/mock/04_platform_config.php
+++ b/examples/mock/04_platform_config.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/05_platform_registry.php b/examples/mock/05_platform_registry.php
index 6da8b4d..61a397c 100644
--- a/examples/mock/05_platform_registry.php
+++ b/examples/mock/05_platform_registry.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/06_publishing.php b/examples/mock/06_publishing.php
index 6a67fb1..816183f 100644
--- a/examples/mock/06_publishing.php
+++ b/examples/mock/06_publishing.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/07_error_handling.php b/examples/mock/07_error_handling.php
index 63a049e..a7f93c3 100644
--- a/examples/mock/07_error_handling.php
+++ b/examples/mock/07_error_handling.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/08_events.php b/examples/mock/08_events.php
index 738c25b..de9acca 100644
--- a/examples/mock/08_events.php
+++ b/examples/mock/08_events.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/09_support_utilities.php b/examples/mock/09_support_utilities.php
index 0fa5df9..fad8ba0 100644
--- a/examples/mock/09_support_utilities.php
+++ b/examples/mock/09_support_utilities.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/10_auth_oauth.php b/examples/mock/10_auth_oauth.php
index ad8c2f0..9bb5f21 100644
--- a/examples/mock/10_auth_oauth.php
+++ b/examples/mock/10_auth_oauth.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/11_delivery_status.php b/examples/mock/11_delivery_status.php
index 59b5d80..ed5000d 100644
--- a/examples/mock/11_delivery_status.php
+++ b/examples/mock/11_delivery_status.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/12_full_workflow.php b/examples/mock/12_full_workflow.php
index 99cb6be..6e6ca5a 100644
--- a/examples/mock/12_full_workflow.php
+++ b/examples/mock/12_full_workflow.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/platform_discord.php b/examples/mock/platform_discord.php
index 6dd0443..35b1239 100644
--- a/examples/mock/platform_discord.php
+++ b/examples/mock/platform_discord.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/platform_instagram.php b/examples/mock/platform_instagram.php
index eddd3b2..8013f92 100644
--- a/examples/mock/platform_instagram.php
+++ b/examples/mock/platform_instagram.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/platform_pinterest.php b/examples/mock/platform_pinterest.php
index 0e006f4..da60976 100644
--- a/examples/mock/platform_pinterest.php
+++ b/examples/mock/platform_pinterest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/platform_reddit.php b/examples/mock/platform_reddit.php
index 9a16ac5..5a1001a 100644
--- a/examples/mock/platform_reddit.php
+++ b/examples/mock/platform_reddit.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/examples/mock/platform_slack.php b/examples/mock/platform_slack.php
index 6dccfff..643a7f5 100644
--- a/examples/mock/platform_slack.php
+++ b/examples/mock/platform_slack.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Slack Platform Integration Example
diff --git a/examples/mock/platform_tumblr.php b/examples/mock/platform_tumblr.php
index 4acf5f5..60be150 100644
--- a/examples/mock/platform_tumblr.php
+++ b/examples/mock/platform_tumblr.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Tumblr Platform Integration Example
diff --git a/examples/mock/platform_whatsapp.php b/examples/mock/platform_whatsapp.php
index 2ff6b26..ee33598 100644
--- a/examples/mock/platform_whatsapp.php
+++ b/examples/mock/platform_whatsapp.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * WhatsApp Platform Integration Example
diff --git a/examples/real/helpers.php b/examples/real/helpers.php
index b0fdcf7..864e854 100644
--- a/examples/real/helpers.php
+++ b/examples/real/helpers.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Shared helpers for real API examples.
diff --git a/examples/real/platform_discord.php b/examples/real/platform_discord.php
index f7646fe..a276c07 100644
--- a/examples/real/platform_discord.php
+++ b/examples/real/platform_discord.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Discord — Real API Example
diff --git a/examples/real/platform_facebook.php b/examples/real/platform_facebook.php
index 8ff1859..00add99 100644
--- a/examples/real/platform_facebook.php
+++ b/examples/real/platform_facebook.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Facebook — Real API Example
diff --git a/examples/real/platform_instagram.php b/examples/real/platform_instagram.php
index d4427b3..ae9d896 100644
--- a/examples/real/platform_instagram.php
+++ b/examples/real/platform_instagram.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Instagram — Real API Example
diff --git a/examples/real/platform_linkedin.php b/examples/real/platform_linkedin.php
index 4069441..79f5dab 100644
--- a/examples/real/platform_linkedin.php
+++ b/examples/real/platform_linkedin.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * LinkedIn — Real API Example
diff --git a/examples/real/platform_pinterest.php b/examples/real/platform_pinterest.php
index 87de834..6f09f1a 100644
--- a/examples/real/platform_pinterest.php
+++ b/examples/real/platform_pinterest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Pinterest — Real API Example
diff --git a/examples/real/platform_reddit.php b/examples/real/platform_reddit.php
index d7f1750..a939e1d 100644
--- a/examples/real/platform_reddit.php
+++ b/examples/real/platform_reddit.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Reddit — Real API Example
diff --git a/examples/real/platform_slack.php b/examples/real/platform_slack.php
index f1cba5b..d7f0999 100644
--- a/examples/real/platform_slack.php
+++ b/examples/real/platform_slack.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Slack — Real API Example
diff --git a/examples/real/platform_telegram.php b/examples/real/platform_telegram.php
index d9fff71..47de0e7 100644
--- a/examples/real/platform_telegram.php
+++ b/examples/real/platform_telegram.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Telegram — Real API Example
diff --git a/examples/real/platform_tumblr.php b/examples/real/platform_tumblr.php
index 3fe279b..81afa7c 100644
--- a/examples/real/platform_tumblr.php
+++ b/examples/real/platform_tumblr.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Tumblr — Real API Example
diff --git a/examples/real/platform_twitter.php b/examples/real/platform_twitter.php
index 23eb0e5..32c5f08 100644
--- a/examples/real/platform_twitter.php
+++ b/examples/real/platform_twitter.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * Twitter/X — Real API Example
diff --git a/examples/real/platform_whatsapp.php b/examples/real/platform_whatsapp.php
index c7c1e30..8baee99 100644
--- a/examples/real/platform_whatsapp.php
+++ b/examples/real/platform_whatsapp.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress,Universal.Operators.DisallowShortTernary -- Example files for framework-agnostic library.
 
 /**
  * WhatsApp — Real API Example
diff --git a/src/Auth/OAuthHandler.php b/src/Auth/OAuthHandler.php
index 64dcda1..d0ec49e 100644
--- a/src/Auth/OAuthHandler.php
+++ b/src/Auth/OAuthHandler.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Auth;
 
 use Owlstack\Core\Auth\Contracts\OAuthProviderInterface;
diff --git a/src/Config/ConfigValidator.php b/src/Config/ConfigValidator.php
index 0e93e18..fd697ee 100644
--- a/src/Config/ConfigValidator.php
+++ b/src/Config/ConfigValidator.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Config;
 
 use Owlstack\Core\Exceptions\OwlstackException;
diff --git a/src/Config/PlatformCredentials.php b/src/Config/PlatformCredentials.php
index b3d79ec..2ffb718 100644
--- a/src/Config/PlatformCredentials.php
+++ b/src/Config/PlatformCredentials.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Config;
 
 /**
diff --git a/src/Http/HttpClient.php b/src/Http/HttpClient.php
index e7e408c..1bf24b0 100644
--- a/src/Http/HttpClient.php
+++ b/src/Http/HttpClient.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic HTTP client; uses native cURL/file functions for portability.
+// phpcs:disable WordPress.PHP.DiscouragedPHPFunctions -- base64_encode/urlencode required for multipart encoding.
+// phpcs:disable WordPress.PHP.NoSilencedErrors.Discouraged -- @unlink used for temp file cleanup.
+
 namespace Owlstack\Core\Http;
 
 use Owlstack\Core\Http\Contracts\HttpClientInterface;
diff --git a/src/Platforms/Discord/DiscordPlatform.php b/src/Platforms/Discord/DiscordPlatform.php
index 6938d57..16fb49b 100644
--- a/src/Platforms/Discord/DiscordPlatform.php
+++ b/src/Platforms/Discord/DiscordPlatform.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Platforms\Discord;
 
 use Owlstack\Core\Content\Post;
diff --git a/src/Platforms/Facebook/FacebookPlatform.php b/src/Platforms/Facebook/FacebookPlatform.php
index 5faf182..fdfb001 100644
--- a/src/Platforms/Facebook/FacebookPlatform.php
+++ b/src/Platforms/Facebook/FacebookPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+
 namespace Owlstack\Core\Platforms\Facebook;
 
 use Owlstack\Core\Content\Post;
diff --git a/src/Platforms/Instagram/InstagramPlatform.php b/src/Platforms/Instagram/InstagramPlatform.php
index 3f73710..1d692db 100644
--- a/src/Platforms/Instagram/InstagramPlatform.php
+++ b/src/Platforms/Instagram/InstagramPlatform.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+
 namespace Owlstack\Core\Platforms\Instagram;
 
 use Owlstack\Core\Config\PlatformCredentials;
diff --git a/src/Platforms/LinkedIn/LinkedInPlatform.php b/src/Platforms/LinkedIn/LinkedInPlatform.php
index 5dee99c..a29c066 100644
--- a/src/Platforms/LinkedIn/LinkedInPlatform.php
+++ b/src/Platforms/LinkedIn/LinkedInPlatform.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+// phpcs:disable WordPress.PHP.DiscouragedPHPFunctions -- urlencode required for URN encoding in API calls.
+
 namespace Owlstack\Core\Platforms\LinkedIn;
 
 use Owlstack\Core\Content\Post;
diff --git a/src/Platforms/Pinterest/PinterestPlatform.php b/src/Platforms/Pinterest/PinterestPlatform.php
index e1d121c..eb1d0d5 100644
--- a/src/Platforms/Pinterest/PinterestPlatform.php
+++ b/src/Platforms/Pinterest/PinterestPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+
 namespace Owlstack\Core\Platforms\Pinterest;
 
 use Owlstack\Core\Config\PlatformCredentials;
diff --git a/src/Platforms/PlatformRegistry.php b/src/Platforms/PlatformRegistry.php
index 60a69d0..b308278 100644
--- a/src/Platforms/PlatformRegistry.php
+++ b/src/Platforms/PlatformRegistry.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Platforms;
 
 use Owlstack\Core\Platforms\Contracts\PlatformInterface;
diff --git a/src/Platforms/Reddit/RedditPlatform.php b/src/Platforms/Reddit/RedditPlatform.php
index 646936a..e34dfff 100644
--- a/src/Platforms/Reddit/RedditPlatform.php
+++ b/src/Platforms/Reddit/RedditPlatform.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+
 namespace Owlstack\Core\Platforms\Reddit;
 
 use Owlstack\Core\Content\Post;
diff --git a/src/Platforms/Slack/SlackPlatform.php b/src/Platforms/Slack/SlackPlatform.php
index faad44a..7aaab9f 100644
--- a/src/Platforms/Slack/SlackPlatform.php
+++ b/src/Platforms/Slack/SlackPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+
 namespace Owlstack\Core\Platforms\Slack;
 
 use DateTimeImmutable;
diff --git a/src/Platforms/Telegram/TelegramPlatform.php b/src/Platforms/Telegram/TelegramPlatform.php
index c318eb8..d994b25 100644
--- a/src/Platforms/Telegram/TelegramPlatform.php
+++ b/src/Platforms/Telegram/TelegramPlatform.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+
 namespace Owlstack\Core\Platforms\Telegram;
 
 use Owlstack\Core\Content\Media;
diff --git a/src/Platforms/Tumblr/TumblrPlatform.php b/src/Platforms/Tumblr/TumblrPlatform.php
index 7563639..c900855 100644
--- a/src/Platforms/Tumblr/TumblrPlatform.php
+++ b/src/Platforms/Tumblr/TumblrPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+
 namespace Owlstack\Core\Platforms\Tumblr;
 
 use Owlstack\Core\Config\PlatformCredentials;
diff --git a/src/Platforms/Twitter/TwitterPlatform.php b/src/Platforms/Twitter/TwitterPlatform.php
index 30ebe92..d7d520e 100644
--- a/src/Platforms/Twitter/TwitterPlatform.php
+++ b/src/Platforms/Twitter/TwitterPlatform.php
@@ -2,6 +2,10 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Framework-agnostic library; uses native PHP functions for portability.
+// phpcs:disable WordPress.PHP.DiscouragedPHPFunctions -- base64_encode required for OAuth HMAC-SHA1 signature and media upload.
+
 namespace Owlstack\Core\Platforms\Twitter;
 
 use Owlstack\Core\Content\Media;
diff --git a/src/Platforms/WhatsApp/WhatsAppPlatform.php b/src/Platforms/WhatsApp/WhatsAppPlatform.php
index bd62c77..5efe399 100644
--- a/src/Platforms/WhatsApp/WhatsAppPlatform.php
+++ b/src/Platforms/WhatsApp/WhatsAppPlatform.php
@@ -2,6 +2,9 @@
 
 declare(strict_types=1);
 
+// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Framework-agnostic library; exceptions are not WordPress output.
+// phpcs:disable Universal.Operators.DisallowShortTernary.Found -- Short ternary used intentionally for concise null/empty fallbacks.
+
 namespace Owlstack\Core\Platforms\WhatsApp;
 
 use Owlstack\Core\Config\PlatformCredentials;
diff --git a/tests/Unit/Platforms/Discord/DiscordFormatterTest.php b/tests/Unit/Platforms/Discord/DiscordFormatterTest.php
index e517b31..c25802d 100644
--- a/tests/Unit/Platforms/Discord/DiscordFormatterTest.php
+++ b/tests/Unit/Platforms/Discord/DiscordFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Discord/DiscordPlatformTest.php b/tests/Unit/Platforms/Discord/DiscordPlatformTest.php
index 622dd9a..e21a42b 100644
--- a/tests/Unit/Platforms/Discord/DiscordPlatformTest.php
+++ b/tests/Unit/Platforms/Discord/DiscordPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Facebook/FacebookFormatterTest.php b/tests/Unit/Platforms/Facebook/FacebookFormatterTest.php
index 3b41a94..70dc803 100644
--- a/tests/Unit/Platforms/Facebook/FacebookFormatterTest.php
+++ b/tests/Unit/Platforms/Facebook/FacebookFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Facebook/FacebookPlatformTest.php b/tests/Unit/Platforms/Facebook/FacebookPlatformTest.php
index e814ef3..eaa71c0 100644
--- a/tests/Unit/Platforms/Facebook/FacebookPlatformTest.php
+++ b/tests/Unit/Platforms/Facebook/FacebookPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Instagram/InstagramFormatterTest.php b/tests/Unit/Platforms/Instagram/InstagramFormatterTest.php
index f7019e5..1b16590 100644
--- a/tests/Unit/Platforms/Instagram/InstagramFormatterTest.php
+++ b/tests/Unit/Platforms/Instagram/InstagramFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Instagram/InstagramPlatformTest.php b/tests/Unit/Platforms/Instagram/InstagramPlatformTest.php
index 481d8e5..c66ef3e 100644
--- a/tests/Unit/Platforms/Instagram/InstagramPlatformTest.php
+++ b/tests/Unit/Platforms/Instagram/InstagramPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/LinkedIn/LinkedInFormatterTest.php b/tests/Unit/Platforms/LinkedIn/LinkedInFormatterTest.php
index bd80fbc..c0a1607 100644
--- a/tests/Unit/Platforms/LinkedIn/LinkedInFormatterTest.php
+++ b/tests/Unit/Platforms/LinkedIn/LinkedInFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/LinkedIn/LinkedInPlatformTest.php b/tests/Unit/Platforms/LinkedIn/LinkedInPlatformTest.php
index ff1831d..cd02a74 100644
--- a/tests/Unit/Platforms/LinkedIn/LinkedInPlatformTest.php
+++ b/tests/Unit/Platforms/LinkedIn/LinkedInPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Pinterest/PinterestFormatterTest.php b/tests/Unit/Platforms/Pinterest/PinterestFormatterTest.php
index 2f30237..25a803a 100644
--- a/tests/Unit/Platforms/Pinterest/PinterestFormatterTest.php
+++ b/tests/Unit/Platforms/Pinterest/PinterestFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Pinterest/PinterestPlatformTest.php b/tests/Unit/Platforms/Pinterest/PinterestPlatformTest.php
index 3539526..07676bc 100644
--- a/tests/Unit/Platforms/Pinterest/PinterestPlatformTest.php
+++ b/tests/Unit/Platforms/Pinterest/PinterestPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Reddit/RedditFormatterTest.php b/tests/Unit/Platforms/Reddit/RedditFormatterTest.php
index d39878d..72a5fd1 100644
--- a/tests/Unit/Platforms/Reddit/RedditFormatterTest.php
+++ b/tests/Unit/Platforms/Reddit/RedditFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Reddit/RedditPlatformTest.php b/tests/Unit/Platforms/Reddit/RedditPlatformTest.php
index 18ed7aa..931358b 100644
--- a/tests/Unit/Platforms/Reddit/RedditPlatformTest.php
+++ b/tests/Unit/Platforms/Reddit/RedditPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Slack/SlackFormatterTest.php b/tests/Unit/Platforms/Slack/SlackFormatterTest.php
index f8f82a2..8e68bfb 100644
--- a/tests/Unit/Platforms/Slack/SlackFormatterTest.php
+++ b/tests/Unit/Platforms/Slack/SlackFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Slack/SlackPlatformTest.php b/tests/Unit/Platforms/Slack/SlackPlatformTest.php
index c7eeb01..63c02e1 100644
--- a/tests/Unit/Platforms/Slack/SlackPlatformTest.php
+++ b/tests/Unit/Platforms/Slack/SlackPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Telegram/TelegramFormatterTest.php b/tests/Unit/Platforms/Telegram/TelegramFormatterTest.php
index bbb7cc7..f2374e6 100644
--- a/tests/Unit/Platforms/Telegram/TelegramFormatterTest.php
+++ b/tests/Unit/Platforms/Telegram/TelegramFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Telegram/TelegramPlatformTest.php b/tests/Unit/Platforms/Telegram/TelegramPlatformTest.php
index 754b238..266a773 100644
--- a/tests/Unit/Platforms/Telegram/TelegramPlatformTest.php
+++ b/tests/Unit/Platforms/Telegram/TelegramPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Tumblr/TumblrFormatterTest.php b/tests/Unit/Platforms/Tumblr/TumblrFormatterTest.php
index 3660f43..cd5dbc8 100644
--- a/tests/Unit/Platforms/Tumblr/TumblrFormatterTest.php
+++ b/tests/Unit/Platforms/Tumblr/TumblrFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Tumblr/TumblrPlatformTest.php b/tests/Unit/Platforms/Tumblr/TumblrPlatformTest.php
index bde9653..55acb74 100644
--- a/tests/Unit/Platforms/Tumblr/TumblrPlatformTest.php
+++ b/tests/Unit/Platforms/Tumblr/TumblrPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Twitter/TwitterFormatterTest.php b/tests/Unit/Platforms/Twitter/TwitterFormatterTest.php
index 3030b2c..04d7958 100644
--- a/tests/Unit/Platforms/Twitter/TwitterFormatterTest.php
+++ b/tests/Unit/Platforms/Twitter/TwitterFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/Twitter/TwitterPlatformTest.php b/tests/Unit/Platforms/Twitter/TwitterPlatformTest.php
index a27c37d..8e0e740 100644
--- a/tests/Unit/Platforms/Twitter/TwitterPlatformTest.php
+++ b/tests/Unit/Platforms/Twitter/TwitterPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/WhatsApp/WhatsAppFormatterTest.php b/tests/Unit/Platforms/WhatsApp/WhatsAppFormatterTest.php
index 68a31f9..6dbf947 100644
--- a/tests/Unit/Platforms/WhatsApp/WhatsAppFormatterTest.php
+++ b/tests/Unit/Platforms/WhatsApp/WhatsAppFormatterTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);
 
diff --git a/tests/Unit/Platforms/WhatsApp/WhatsAppPlatformTest.php b/tests/Unit/Platforms/WhatsApp/WhatsAppPlatformTest.php
index 989ac6b..0d01fe7 100644
--- a/tests/Unit/Platforms/WhatsApp/WhatsAppPlatformTest.php
+++ b/tests/Unit/Platforms/WhatsApp/WhatsAppPlatformTest.php
@@ -1,4 +1,5 @@
 <?php
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Test files for framework-agnostic library.
 
 declare(strict_types=1);