Fix PHPStan and PSR-12 linter errors

- Add array shape type to findAggregatedFromTable $parsed parameter
  so PHPStan recognizes typed keys (filters, params, orderBy)
- Provide default for optional groupByInterval key access
- Split compound type check for $interval to satisfy PHPStan
  string narrowing in exception message interpolation
- Remove extra trailing blank line in UsageBase.php (PSR-12)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: lohanidamodar

src/Usage/Adapter/ClickHouse.php

@@ -1490,7 +1490,7 @@ private function findFromTable(array $queries, string $type): array
      *          toStartOfInterval(time, INTERVAL 1 HOUR) as time
      *   FROM table WHERE ... GROUP BY metric, time ORDER BY time ASC
      *
-     * @param array<string, mixed> $parsed Parsed query data from parseQueries()
+     * @param array{filters: array<string>, params: array<string, mixed>, orderBy?: array<string>, limit?: int, offset?: int, groupByInterval?: string} $parsed Parsed query data from parseQueries()
      * @param string $fromTable Fully qualified table reference
      * @param string $type 'event' or 'gauge'
      * @return array<Metric>
@@ -1499,7 +1499,7 @@ private function findFromTable(array $queries, string $type): array
     private function findAggregatedFromTable(array $parsed, string $fromTable, string $type): array
     {
         /** @var string $interval */
-        $interval = $parsed['groupByInterval'];
+        $interval = $parsed['groupByInterval'] ?? '1h';
         $intervalSql = UsageQuery::VALID_INTERVALS[$interval];
 
         // Choose aggregation function based on metric type
@@ -2542,7 +2542,13 @@ private function parseQueries(array $queries, string $type = 'event'): array
                 case UsageQuery::TYPE_GROUP_BY_INTERVAL:
                     $this->validateAttributeName($attribute, $type);
                     $interval = $values[0] ?? '1h';
-                    if (!is_string($interval) || !isset(UsageQuery::VALID_INTERVALS[$interval])) {
+                    if (!is_string($interval)) {
+                        throw new \Exception(
+                            'Invalid groupByInterval interval: expected string, got ' . get_debug_type($interval) . '. Allowed: '
+                            . implode(', ', array_keys(UsageQuery::VALID_INTERVALS))
+                        );
+                    }
+                    if (!isset(UsageQuery::VALID_INTERVALS[$interval])) {
                         throw new \Exception(
                             "Invalid groupByInterval interval '{$interval}'. Allowed: "
                             . implode(', ', array_keys(UsageQuery::VALID_INTERVALS))

tests/Usage/UsageBase.php

@@ -640,4 +640,3 @@ public function testGroupByIntervalWithLimitOffset(): void
         $this->assertGreaterThanOrEqual(1, count($results));
     }
 }
-