Trace attr (#14)

* feat(core): make tracing opt-in per method

Previously `#[Trace]` on a class traced all public methods, filtered
by include/exclude lists on the class attribute. Method selection now
relies solely on the presence of `#[TraceMethod]`, so each method is
traced explicitly regardless of visibility.

Remove the include/exclude constructor from `Trace`, since scoping is
no longer driven by the class attribute. Scan all methods and skip
those without `#[TraceMethod]`, moving the attribute lookup into the
loop and passing it straight to `scanMethod`.

* test(class): align fixtures and tests with opt-in tracing

Drop fixtures and cases for the removed include/exclude method
filtering and consolidate the per-type argument fixtures onto the
shared MixedArgument, since tracing is now opt-in via TraceMethod.
Rework MixedVisibility to trace all visibilities and assert every
level is hooked. Exclude Fixtures from php-cs-fixer so intentional
test shapes aren't reformatted.

* docs(readme): reframe messaging around opt-in per-method tracing

Rewrite package descriptions and README examples to match the
opt-in model shipped in b7e57c9. The old "one tag, full
visibility" pitch implied `#[Trace]` alone spans every method,
which is no longer true — `#[Trace]` only marks a class and each
method needs its own `#[TraceMethod]`. Drop the stale
`include`/`exclude` method-selection docs and lead with the value
users actually get: capturing what methods received, returned,
and threw.

Author: eerzho

.php-cs-fixer.dist.php

@@ -2,7 +2,8 @@
 
 $finder = (new PhpCsFixer\Finder())
     ->in([__DIR__ . '/packages', __DIR__ . '/tests'])
-    ->notPath('vendor');
+    ->notPath('vendor')
+    ->exclude('Fixtures');
 
 return (new PhpCsFixer\Config())
     ->setCacheFile('var/.php-cs-fixer.cache')

packages/core/README.md

@@ -5,7 +5,7 @@
 [![PHP](https://img.shields.io/packagist/dependency-v/eerzho/opentelemetry-auto-class/php)](https://packagist.org/packages/eerzho/opentelemetry-auto-class)
 [![License](https://img.shields.io/packagist/l/eerzho/opentelemetry-auto-class)](https://packagist.org/packages/eerzho/opentelemetry-auto-class)
 
-One tag, full visibility — every method call in your PHP app shows up in your traces, no boilerplate, no framework required.
+Trace what your methods received, returned, and threw — without writing a single span. No framework required.
 
 This is a read-only sub-split. Please open issues and pull requests in the [monorepo](https://github.com/eerzho/opentelemetry-auto-class-monorepo).
 
@@ -40,21 +40,20 @@ class Address
 }
 ```
 
-### 1. `#[Trace]` — a span per method
+### 1. `#[Trace]` — mark a class for tracing
 
 ```php
 use Eerzho\Instrumentation\Class\Attribute\Trace;
 
-#[Trace(exclude: ['healthCheck'])]   // trace every public method but healthCheck
-// #[Trace(include: ['pay'])]        // or: only pay
+#[Trace]   // mark the class for tracing
 class OrderService
 {
     public function pay(int $orderId, string $card, Address $address): string {}
     public function healthCheck(): bool {}
 }
 ```
 
-### 2. `#[TraceMethod]` — capture arguments, return value, and exceptions
+### 2. `#[TraceMethod]` — trace a method
 
 ```php
 use Eerzho\Instrumentation\Class\Attribute\TraceMethod;
@@ -64,7 +63,7 @@ use Eerzho\Instrumentation\Class\Attribute\TraceMethod;
 public function pay(int $orderId, string $card, Address $address): string {}
 ```
 
-By default, it captures the arguments and the return value, and records exceptions. Turn each off with `arguments: false`, `return: false`, or `exception: false` (a disabled exception still sets the span status to `ERROR`, only its event is omitted).
+A method gets a span with `#[TraceMethod]`. By default, it captures the arguments and the return value, and records exceptions. Turn each off with `arguments: false`, `return: false`, or `exception: false` (a disabled exception still sets the span status to `ERROR`, only its event is omitted).
 
 ### 3. `#[TraceProperties]` — expand an object argument
 
@@ -114,7 +113,7 @@ Each method maps to its `arguments` (`name => position`) plus the `return` and `
 
 ### Selecting what to trace
 
-`include` and `exclude` behave the same wherever they appear — `#[Trace]`, `#[TraceMethod]`, `#[TraceProperties]`:
+`include` and `exclude` behave the same wherever they appear — `#[TraceMethod]` (arguments) and `#[TraceProperties]` (properties):
 
 | `include` | `exclude` | Result                                    |
 |-----------|-----------|-------------------------------------------|
@@ -125,7 +124,7 @@ Each method maps to its `arguments` (`name => position`) plus the `return` and `
 
 An empty `include` means "no allowlist" (everything), **not** "nothing".
 
-Only **public** methods are traced and only **public** properties are expanded — protected and private are ignored.
+Only **public** properties are expanded — non-public properties are ignored.
 
 ### Argument serialization
 
@@ -179,7 +178,7 @@ With `exception: false` the status still becomes `ERROR`, but the event above is
 
 1. Skips abstract classes, interfaces, traits, and enums.
 2. Reads `#[Trace]` on the class — no attribute, no instrumentation.
-3. Collects the public methods allowed by `include` / `exclude`, and for each the arguments, return value, and exception recording configured by `#[TraceMethod]`.
+3. Collects every method carrying `#[TraceMethod]`, and for each the arguments, return value, and exception recording it configures.
 
 It returns a `class → method → {arguments, return, exception}` map. `ClassInstrumentation::register()` then installs an `ext-opentelemetry` hook on every mapped method:
 

packages/core/composer.json

@@ -1,6 +1,6 @@
 {
   "name": "eerzho/opentelemetry-auto-class",
-  "description": "One tag, full visibility — every method call in your PHP app shows up in your traces, no boilerplate, no framework required.",
+  "description": "Trace what your methods received, returned, and threw — without writing a single span. No framework required.",
   "type": "library",
   "license": "MIT",
   "keywords": [

packages/core/src/Attribute/Trace.php

@@ -9,13 +9,4 @@
 #[Attribute(Attribute::TARGET_CLASS)]
 final readonly class Trace
 {
-    /**
-     * @param list<string> $include
-     * @param list<string> $exclude
-     */
-    public function __construct(
-        public array $include = [],
-        public array $exclude = [],
-    ) {
-    }
 }

packages/core/src/AttributeScanner.php

@@ -65,15 +65,15 @@ private static function scanClass(string $class): array
      */
     private static function scanMethods(ReflectionClass $class): array
     {
-        $attribute = self::findTrace($class);
-        if ($attribute === null) {
+        if (self::findTrace($class) === null) {
             return [];
         }
 
         $methodsMap = [];
-        foreach ($class->getMethods(ReflectionMethod::IS_PUBLIC) as $method) {
-            if (self::isAllowed($method->getName(), $attribute->include, $attribute->exclude)) {
-                $methodsMap[$method->getName()] = self::scanMethod($method);
+        foreach ($class->getMethods() as $method) {
+            $attribute = self::findTraceMethod($method);
+            if ($attribute !== null) {
+                $methodsMap[$method->getName()] = self::scanMethod($method, $attribute);
             }
         }
 
@@ -83,13 +83,8 @@ private static function scanMethods(ReflectionClass $class): array
     /**
      * @return array{arguments: array<string, int>, return: bool, exception: bool}
      */
-    private static function scanMethod(ReflectionMethod $method): array
+    private static function scanMethod(ReflectionMethod $method, TraceMethod $attribute): array
     {
-        $attribute = self::findTraceMethod($method);
-        if ($attribute === null) {
-            return ['arguments' => [], 'return' => false, 'exception' => false];
-        }
-
         $arguments = [];
         if ($attribute->arguments) {
             foreach ($method->getParameters() as $parameter) {

packages/laravel/README.md

@@ -5,7 +5,7 @@
 [![PHP](https://img.shields.io/packagist/dependency-v/eerzho/opentelemetry-auto-class-laravel/php)](https://packagist.org/packages/eerzho/opentelemetry-auto-class-laravel)
 [![License](https://img.shields.io/packagist/l/eerzho/opentelemetry-auto-class-laravel)](https://packagist.org/packages/eerzho/opentelemetry-auto-class-laravel)
 
-One tag, full visibility — every method call in your Laravel app shows up in your traces, zero config.
+Trace what your Laravel methods received, returned, and threw — without writing a single span.
 
 The Laravel integration for [opentelemetry-auto-class](https://github.com/eerzho/opentelemetry-auto-class) — your classes are discovered and registered automatically.
 
@@ -52,14 +52,14 @@ use Eerzho\Instrumentation\Class\Attribute\Trace;
 use Eerzho\Instrumentation\Class\Attribute\TraceMethod;
 use Eerzho\Instrumentation\Class\Attribute\TraceProperties;
 
-#[Trace(exclude: ['healthCheck'])]         // trace public methods, but hide "healthCheck"
+#[Trace]                                   // mark the class for tracing
 class OrderService
 {
     // span "App\Services\OrderService::pay"
     #[TraceMethod(exclude: ['card'])]   // hide "card" from the span
     public function pay(int $orderId, string $card, Address $address): void {}
 
-    public function healthCheck(): bool {}
+    public function healthCheck(): bool {}   // no #[TraceMethod] -> not traced
 }
 
 #[TraceProperties(exclude: ['zip'])]       // expand public props, but hide "zip"

packages/laravel/composer.json

@@ -1,6 +1,6 @@
 {
   "name": "eerzho/opentelemetry-auto-class-laravel",
-  "description": "One tag, full visibility — every method call in your Laravel app shows up in your traces, zero config.",
+  "description": "Trace what your Laravel methods received, returned, and threw — without writing a single span.",
   "type": "library",
   "license": "MIT",
   "keywords": [

packages/symfony/README.md

@@ -5,7 +5,7 @@
 [![PHP](https://img.shields.io/packagist/dependency-v/eerzho/opentelemetry-auto-class-symfony/php)](https://packagist.org/packages/eerzho/opentelemetry-auto-class-symfony)
 [![License](https://img.shields.io/packagist/l/eerzho/opentelemetry-auto-class-symfony)](https://packagist.org/packages/eerzho/opentelemetry-auto-class-symfony)
 
-One tag, full visibility — every method call in your Symfony app shows up in your traces, zero config.
+Trace what your Symfony methods received, returned, and threw — without writing a single span.
 
 The Symfony integration for [opentelemetry-auto-class](https://github.com/eerzho/opentelemetry-auto-class) — your classes are discovered and registered automatically.
 
@@ -43,14 +43,14 @@ use Eerzho\Instrumentation\Class\Attribute\Trace;
 use Eerzho\Instrumentation\Class\Attribute\TraceMethod;
 use Eerzho\Instrumentation\Class\Attribute\TraceProperties;
 
-#[Trace(exclude: ['healthCheck'])]         // trace public methods, but hide "healthCheck"
+#[Trace]                                   // mark the class for tracing
 class OrderService
 {
     // span "App\Service\OrderService::pay"
     #[TraceMethod(exclude: ['card'])]   // hide "card" from the span
     public function pay(int $orderId, string $card, Address $address): void {}
 
-    public function healthCheck(): bool {}
+    public function healthCheck(): bool {}   // no #[TraceMethod] -> not traced
 }
 
 #[TraceProperties(exclude: ['zip'])]       // expand public props, but hide "zip"

packages/symfony/composer.json

@@ -1,6 +1,6 @@
 {
   "name": "eerzho/opentelemetry-auto-class-symfony",
-  "description": "One tag, full visibility — every method call in your Symfony app shows up in your traces, zero config.",
+  "description": "Trace what your Symfony methods received, returned, and threw — without writing a single span.",
   "type": "symfony-bundle",
   "license": "MIT",
   "keywords": [