From 765b7749d31675d3cbf541b146ead1aafd6d6ae9 Mon Sep 17 00:00:00 2001
From: nsfisis <nsfisis@gmail.com>
Date: Tue, 21 Jul 2026 02:54:18 +0900
Subject: feat(plugin-class-classifier): add deterministic plugin-boundary
 classifier

Decides, for every composer/composer class, how it is treated at the
plugin boundary (rust-proxy / rust-snapshot / contract / two-world /
php-native / unsupported) so that upstream updates re-classify new or
rewritten classes without re-deriving the design by hand. Rules and
category definitions live in docs/dev/plugin-class-classification.md;
the tool (PHP + nikic/PHP-Parser) implements them as a reachability
closure with direction marks, per-method pure/mutator analysis, and a
leaf-first fixed point for unreachable classes, with three small
versioned exception lists.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../plugin-class-classifier/src/PropertyInfo.php   | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 scripts/plugin-class-classifier/src/PropertyInfo.php

(limited to 'scripts/plugin-class-classifier/src/PropertyInfo.php')

diff --git a/scripts/plugin-class-classifier/src/PropertyInfo.php b/scripts/plugin-class-classifier/src/PropertyInfo.php
new file mode 100644
index 00000000..a15ddcf9
--- /dev/null
+++ b/scripts/plugin-class-classifier/src/PropertyInfo.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Shirabe\PluginClassifier;
+
+final class PropertyInfo
+{
+    public function __construct(
+        public readonly string $name,
+        /** 'public' | 'protected' | 'private' */
+        public readonly string $visibility,
+        public readonly bool $static,
+        /** Class-like FQCNs in the native type. @var list<string> */
+        public readonly array $classTypes,
+        /** Native type is array/iterable/mixed/object or absent. */
+        public readonly bool $expandable,
+        /** Class-like FQCNs from the `@var` docblock. @var list<string> */
+        public readonly array $docblockTypes,
+    ) {
+    }
+}
-- 
cgit v1.3.1