Merge pull request #28 from hametuha/feature/standardize-phpstan-playground

Add PHPStan and Playground preview

Author: fumikito

.claude/CLAUDE.md

@@ -163,5 +163,5 @@ hamelp/
 ## 注意事項
 
 - `wp-dependencies.json` はビルド成果物だが、`.distignore` には入れない（PHPから読み込むため）
-- `composer.lock` は `.gitignore` に入っている（複数PHPバージョンでテストするため）
+- `composer.lock` はコミットする（依存関係の再現性のため。`composer.json` を変更したら必ず `composer install` で更新して一緒にコミットする）
 - `package-lock.json` はコミットする（アセットビルドの一貫性のため）

.distignore

@@ -8,6 +8,7 @@
 .husky
 .travis.yml
 .github
+.node-version
 .wp-env.json
 .DS_Store
 Thumbs.db
@@ -26,6 +27,11 @@ multisite.xml
 multisite.xml.dist
 phpcs.xml
 phpcs.xml.dist
+phpcs.ruleset.xml
+phpstan.neon
+phpstan-baseline.neon
+phpstan-bootstrap.php
+phpstan
 README.md
 wp-cli.local.yml
 yarn.lock

.github/workflows/playground-preview-build.yml

@@ -0,0 +1,17 @@
+name: Playground Preview - Build
+
+on:
+  pull_request:
+    types: [labeled, synchronize, reopened]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    if: >
+      contains(github.event.pull_request.labels.*.name, 'playground') &&
+      (github.event.action != 'labeled' || github.event.label.name == 'playground')
+    uses: tarosky/workflows/.github/workflows/playground-preview-build.yml@main
+    with:
+      build_command: 'composer install --no-dev --prefer-dist && npm ci && npm run package'

.github/workflows/playground-preview-publish.yml

@@ -0,0 +1,18 @@
+name: Playground Preview - Publish
+
+on:
+  workflow_run:
+    workflows: ["Playground Preview - Build"]
+    types:
+      - completed
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  publish:
+    if: >
+      github.event.workflow_run.event == 'pull_request' &&
+      github.event.workflow_run.conclusion == 'success'
+    uses: tarosky/workflows/.github/workflows/playground-preview-publish.yml@main

.github/workflows/test.yml

@@ -39,6 +39,26 @@ jobs:
       - name: PHP CodeSniffer
         run: composer lint
 
+  phpstan:
+    name: PHPStan
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 7.4
+          tools: composer
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install dependencies
+        run: composer install --no-progress
+
+      - name: Run PHPStan
+        run: composer phpstan
+
   phplint:
     uses: tarosky/workflows/.github/workflows/phplint.yml@main
     with:
@@ -70,7 +90,7 @@ jobs:
   status:
     name: Status Check
     runs-on: ubuntu-latest
-    needs: [ test, phpcs, phplint, assets ]
+    needs: [ test, phpcs, phpstan, phplint, assets ]
     if: always()
     steps:
       - uses: re-actors/alls-green@release/v1

.gitignore

@@ -5,7 +5,6 @@
 Thumbs.db
 wp-cli.local.yml
 node_modules/
-composer.lock
 *.sql
 *.tar.gz
 *.zip

.node-version

@@ -0,0 +1 @@
+22

app/Hametuha/Hamelp/Hooks/AiOverview.php

@@ -22,6 +22,12 @@ class AiOverview extends Singleton {
 	 * Initialize hooks.
 	 */
 	protected function init() {
+		// wp-ai-client is bundled in WordPress 7.0+. If it's not available
+		// (older WP), this feature is disabled silently.
+		if ( ! class_exists( AI_Client::class ) ) {
+			return;
+		}
+
 		// Initialize wp-ai-client
 		add_action( 'init', [ AI_Client::class, 'init' ] );
 

composer.json

@@ -12,17 +12,21 @@
 	"scripts": {
 		"test": "phpunit",
 		"lint": "phpcs --standard=phpcs.ruleset.xml",
-		"fix": "phpcbf --standard=phpcs.ruleset.xml"
+		"fix": "phpcbf --standard=phpcs.ruleset.xml",
+		"phpstan": "phpstan analyse --memory-limit=1G"
 	},
 	"minimum-stability": "stable",
 	"require": {
-		"php": ">=7.4",
-		"wordpress/wp-ai-client": "^0.2.1"
+		"php": ">=7.4"
 	},
 	"require-dev": {
 		"phpunit/phpunit": "^9.0",
 		"yoast/phpunit-polyfills": "^4.0",
-		"wp-coding-standards/wpcs": "^3.0"
+		"wp-coding-standards/wpcs": "^3.0",
+		"phpstan/phpstan": "^2.1",
+		"szepeviktor/phpstan-wordpress": "^2.0",
+		"php-stubs/wordpress-stubs": "^6.9",
+		"php-stubs/wp-cli-stubs": "^2.10"
 	},
 	"autoload": {
 		"psr-0": {