gitlab_quality-test_tooling 3.2.0 → 3.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9344fabcbb0c753d63b87584efe906b972a6504e7cdb87ef14f46ec2fdeccab
-  data.tar.gz: 9f30d7e5edebcf6116cd09343bffb4cc3a0946071a5500ac1d4b3372cd034376
+  metadata.gz: 7463b8e510a9decd2156d3167e28d6109c99928b03cc5738be19eba7ecccfa39
+  data.tar.gz: 2094146a3e6ebcbbcf17ede753e5b1c822b8c33b397cc02550b5c17dac1d19a6
 SHA512:
-  metadata.gz: 4596d36fee333944d309fc9eb6428e9cca37990f2cc6ca13914af87f6a4dff208dd993c8c51a9642daf63c50f051e2902a8b6d2647ddf42270c348d7e9c701e5
-  data.tar.gz: 480a96a3a1242d87f946d3e610729c97c374d69cb1b6bd96e7dc1255f4558c505126f5b74fe8e7d730c7c84359138a7e9677eee49c7b616d3362f9d072887046
+  metadata.gz: d1fe5d32ed4521023381d238ad1a5bd17d7b36ea32b9bd888697e0126452a36fab14d2884d3d665f55620cd76d7f9da5048b5bb18b9f61746b0b49e49ed291f5
+  data.tar.gz: df998fa7999ae675f4de19227bef692594427c02c30116f9312fbcc07d73312bcccb634efabafe20cea3fc7fa947bb85feab19829b13b1071fd5e5626ed0c5a9

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    gitlab_quality-test_tooling (3.2.0)
+    gitlab_quality-test_tooling (3.2.1)
       activesupport (>= 7.0)
       amatch (~> 0.4.1)
       fog-google (~> 1.24, >= 1.24.1)

data/exe/test-coverage

@@ -152,7 +152,7 @@ if params.any? && (required_params - params.keys).none?
     code_coverage_by_source_file,
     source_file_to_tests,
     tests_to_categories,
-    category_owners.categories_to_teams,
+    category_owners.feature_categories_to_teams,
     source_file_types,
     test_classifications
   )

data/lib/gitlab_quality/test_tooling/code_coverage/README.md

@@ -5,6 +5,45 @@ Exports test coverage data to ClickHouse, enriched with:
 - **Feature category ownership** - group, stage, and section for each covered file
 - **Responsibility classification** - whether coverage comes from unit or integration tests
 
+## How It Works
+
+### Feature Category Attribution
+
+Coverage data is enriched with feature category ownership by joining three data sources:
+
+1. **Coverage Report** (LCOV) - which source files have coverage and their percentages
+2. **Test Map** - which test files cover each source file
+3. **Test Reports** (JSON) - which feature category each test file belongs to
+
+```mermaid
+flowchart LR
+    subgraph Inputs
+        A["<b>Coverage Report</b><br/>user.rb: 85%"]
+        B["<b>Test Map</b><br/>user.rb → user_spec.rb"]
+        C["<b>Test Reports</b><br/>user_spec.rb → user_profile"]
+    end
+
+    subgraph Output
+        E["<b>ClickHouse Record</b><br/>file: user.rb<br/>feature_category: user_profile<br/>coverage: 85%"]
+    end
+
+    A --> D((Join))
+    B --> D
+    C --> D
+    D --> E
+```
+
+This enables **multi-category attribution**: if a source file is covered by tests from
+multiple feature categories, it creates a separate record for each category in ClickHouse.
+
+### Why All Three Inputs Are Required
+
+| Input | Provides | Without it |
+|-------|----------|------------|
+| Coverage Report | Line/branch coverage percentages | No coverage metrics |
+| Test Map | Source file → test file relationships | No feature category attribution (all records have `category=NULL`) |
+| Test Reports | Test file → feature category metadata | No feature category attribution (all records have `category=NULL`) |
+
 ## Responsibility Classification
 
 Tests are classified as either **responsible** or **dependent**:

data/lib/gitlab_quality/test_tooling/version.rb

@@ -2,6 +2,6 @@
 
 module GitlabQuality
   module TestTooling
-    VERSION = "3.2.0"
+    VERSION = "3.2.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab_quality-test_tooling
 version: !ruby/object:Gem::Version
-  version: 3.2.0
+  version: 3.2.1
 platform: ruby
 authors:
 - GitLab Quality
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-10 00:00:00.000000000 Z
+date: 2025-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: climate_control