fix: buffer key tag-loss, daily column validation, agg_value truncation, getTotal ambiguity

- Buffer key now includes tag hash so events with same metric but
  different tags (e.g. different paths) stay as separate entries
  instead of silently discarding the second call's tags

- Daily table queries (findDaily, sumDaily, sumDailyBatch) now validate
  attributes against the daily schema (metric, value, time, tenant)
  instead of the full event schema. Querying path/method/status on the
  daily table now throws immediately instead of causing a ClickHouse
  "No such column" runtime error

- Changed (int) cast to (float) for agg_value in getTimeSeries to avoid
  truncating fractional gauge values or large event sums

- getTotal() now throws when a metric exists in both event and gauge
  tables instead of silently adding incompatible aggregations

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

Author: lohanidamodar

src/Usage/Adapter/ClickHouse.php

@@ -1146,6 +1146,37 @@ private function validateAttributeName(string $attributeName, string $type = 'ev
         throw new Exception("Invalid attribute name: {$attributeName}");
     }
 
+    /**
+     * Columns available in the events daily (pre-aggregated) table.
+     */
+    private const DAILY_COLUMNS = ['metric', 'value', 'time'];
+
+    /**
+     * Validate that a query attribute exists in the daily table schema.
+     * The daily table only has metric, value, time (+ tenant if shared).
+     *
+     * @throws Exception
+     */
+    private function validateDailyAttributeName(string $attributeName): bool
+    {
+        if ($attributeName === 'id') {
+            return true;
+        }
+
+        if ($attributeName === 'tenant' && $this->sharedTables) {
+            return true;
+        }
+
+        if (in_array($attributeName, self::DAILY_COLUMNS, true)) {
+            return true;
+        }
+
+        throw new Exception(
+            "Invalid attribute '{$attributeName}' for daily table. "
+            . "Only metric, value, time" . ($this->sharedTables ? ", tenant" : "") . " are available."
+        );
+    }
+
     /**
      * Format datetime for ClickHouse compatibility.
      *
@@ -1723,7 +1754,13 @@ public function findDaily(array $queries = []): array
 
         $fromTable = $this->buildTableReference($this->getEventsDailyTableName());
 
-        // Daily table has limited columns — only allow metric, value, time, resource, resourceId, tenant
+        // Validate query attributes against daily table schema (metric, value, time, tenant only)
+        foreach ($queries as $query) {
+            $attr = $query->getAttribute();
+            if (!empty($attr)) {
+                $this->validateDailyAttributeName($attr);
+            }
+        }
         $parsed = $this->parseQueries($queries, Usage::TYPE_EVENT);
         $whereData = $this->buildWhereClause($parsed['filters'], $parsed['params']);
 
@@ -1755,9 +1792,15 @@ public function sumDaily(array $queries = [], string $attribute = 'value'): int
         $this->setOperationContext('sumDaily()');
 
         $fromTable = $this->buildTableReference($this->getEventsDailyTableName());
-        $this->validateAttributeName($attribute, Usage::TYPE_EVENT);
+        $this->validateDailyAttributeName($attribute);
         $escapedAttribute = $this->escapeIdentifier($attribute);
 
+        foreach ($queries as $query) {
+            $attr = $query->getAttribute();
+            if (!empty($attr)) {
+                $this->validateDailyAttributeName($attr);
+            }
+        }
         $parsed = $this->parseQueries($queries, Usage::TYPE_EVENT);
         $whereData = $this->buildWhereClause($parsed['filters'], $parsed['params']);
 
@@ -1785,6 +1828,13 @@ public function sumDailyBatch(array $metrics, array $queries = []): array
 
         $this->setOperationContext('sumDailyBatch()');
 
+        foreach ($queries as $query) {
+            $attr = $query->getAttribute();
+            if (!empty($attr)) {
+                $this->validateDailyAttributeName($attr);
+            }
+        }
+
         $totals = \array_fill_keys($metrics, 0);
 
         $fromTable = $this->buildTableReference($this->getEventsDailyTableName());
@@ -1991,7 +2041,7 @@ private function getTimeSeriesFromTable(array $metrics, string $interval, string
             foreach ($json['data'] as $row) {
                 $metricName = $row['metric'] ?? '';
                 $bucketTime = $row['bucket'] ?? '';
-                $value = (int) ($row['agg_value'] ?? 0);
+                $value = (float) ($row['agg_value'] ?? 0);
 
                 if (!isset($output[$metricName])) {
                     continue;
@@ -2084,12 +2134,11 @@ public function getTotal(string $metric, array $queries = [], ?string $type = nu
         $eventTotal = $this->getTotalFromEvents($metric, $queries);
         $gaugeTotal = $this->getTotalFromGauges($metric, $queries);
 
-        // If we got data from both, prioritize event (they don't overlap in practice)
-        // If only one has data, return that
         if ($eventTotal > 0 && $gaugeTotal > 0) {
-            // A metric shouldn't be in both tables; return whichever is nonzero
-            // In practice, callers specify type for ambiguous cases
-            return $eventTotal + $gaugeTotal;
+            throw new Exception(
+                "Metric '{$metric}' exists in both event and gauge tables. "
+                . "Specify \$type explicitly to avoid ambiguous aggregation."
+            );
         }
 
         return $eventTotal > 0 ? $eventTotal : $gaugeTotal;

src/Usage/Usage.php

@@ -299,10 +299,11 @@ public function collect(string $metric, int $value, string $type, array $tags =
             throw new \InvalidArgumentException("Invalid metric type '{$type}'. Allowed: " . self::TYPE_EVENT . ', ' . self::TYPE_GAUGE);
         }
 
-        $key = $metric . ':' . $type;
+        $tagsHash = !empty($tags) ? md5(json_encode($tags)) : '';
+        $key = $metric . ':' . $type . ':' . $tagsHash;
 
         if ($type === 'event') {
-            // Additive: sum values for the same metric
+            // Additive: sum values for the same metric + tags combination
             if (isset($this->buffer[$key])) {
                 $this->buffer[$key]['value'] += $value;
             } else {