analytics_ops 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +108 -0
  3. data/CONTRIBUTING.md +1 -0
  4. data/README.md +141 -13
  5. data/SECURITY.md +11 -2
  6. data/docs/ai-connections.md +192 -0
  7. data/docs/api-support-matrix.md +25 -8
  8. data/docs/architecture.md +78 -17
  9. data/docs/authentication.md +53 -3
  10. data/docs/bigquery.md +128 -0
  11. data/docs/commands.md +133 -12
  12. data/docs/configuration-schema-v1.json +608 -50
  13. data/docs/configuration.md +118 -5
  14. data/docs/google-client-compatibility.md +21 -1
  15. data/docs/governance.md +93 -0
  16. data/docs/health.md +82 -0
  17. data/docs/live-smoke-test.md +13 -10
  18. data/docs/rails.md +25 -9
  19. data/docs/reports.md +165 -3
  20. data/docs/safety.md +37 -5
  21. data/docs/troubleshooting.md +81 -7
  22. data/lib/analytics_ops/bigquery/definition.rb +173 -0
  23. data/lib/analytics_ops/bigquery.rb +4 -0
  24. data/lib/analytics_ops/cli/local_commands.rb +80 -0
  25. data/lib/analytics_ops/cli/options.rb +282 -9
  26. data/lib/analytics_ops/cli/presenter.rb +263 -28
  27. data/lib/analytics_ops/cli/presenter_csv.rb +92 -0
  28. data/lib/analytics_ops/cli/reporting_commands.rb +129 -0
  29. data/lib/analytics_ops/cli/setup_commands.rb +91 -0
  30. data/lib/analytics_ops/cli.rb +121 -44
  31. data/lib/analytics_ops/clients/admin.rb +28 -2
  32. data/lib/analytics_ops/clients/admin_governance.rb +95 -0
  33. data/lib/analytics_ops/clients/admin_governance_normalization.rb +90 -0
  34. data/lib/analytics_ops/clients/admin_resource_normalization.rb +61 -0
  35. data/lib/analytics_ops/clients/bigquery.rb +313 -0
  36. data/lib/analytics_ops/clients/data.rb +147 -54
  37. data/lib/analytics_ops/clients/data_result_normalization.rb +55 -0
  38. data/lib/analytics_ops/clients/error_translation.rb +13 -1
  39. data/lib/analytics_ops/configuration/schema.rb +175 -1
  40. data/lib/analytics_ops/configuration/validator.rb +45 -7
  41. data/lib/analytics_ops/configuration/validator_experimental.rb +136 -0
  42. data/lib/analytics_ops/configuration/validator_reporting.rb +93 -0
  43. data/lib/analytics_ops/configuration/writer.rb +112 -7
  44. data/lib/analytics_ops/desired_state.rb +28 -3
  45. data/lib/analytics_ops/errors.rb +33 -1
  46. data/lib/analytics_ops/funnels.rb +58 -0
  47. data/lib/analytics_ops/governance.rb +363 -0
  48. data/lib/analytics_ops/health.rb +310 -0
  49. data/lib/analytics_ops/mcp_server/custom_report_tool.rb +101 -0
  50. data/lib/analytics_ops/mcp_server/discovery_tools.rb +79 -0
  51. data/lib/analytics_ops/mcp_server/experimental_tools.rb +89 -0
  52. data/lib/analytics_ops/mcp_server/health_tools.rb +80 -0
  53. data/lib/analytics_ops/mcp_server/overview_tools.rb +49 -0
  54. data/lib/analytics_ops/mcp_server/standard_report_tool.rb +53 -0
  55. data/lib/analytics_ops/mcp_server.rb +402 -0
  56. data/lib/analytics_ops/portfolio.rb +216 -0
  57. data/lib/analytics_ops/rails/railtie.rb +19 -8
  58. data/lib/analytics_ops/redaction.rb +10 -6
  59. data/lib/analytics_ops/reports/csv_export.rb +91 -0
  60. data/lib/analytics_ops/reports/definition.rb +152 -14
  61. data/lib/analytics_ops/reports/metadata.rb +158 -0
  62. data/lib/analytics_ops/reports/period.rb +104 -0
  63. data/lib/analytics_ops/reports/result.rb +8 -3
  64. data/lib/analytics_ops/reports.rb +3 -0
  65. data/lib/analytics_ops/service_account.rb +321 -29
  66. data/lib/analytics_ops/setup.rb +31 -7
  67. data/lib/analytics_ops/version.rb +1 -1
  68. data/lib/analytics_ops/workspace.rb +222 -10
  69. data/lib/analytics_ops.rb +7 -2
  70. data/lib/generators/analytics_ops/templates/analytics_ops.yml +1 -1
  71. data/sig/analytics_ops.rbs +494 -9
  72. metadata +60 -1
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: analytics_ops
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ version: 0.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Nelson Chaves
@@ -9,6 +9,20 @@ bindir: exe
9
9
  cert_chain: []
10
10
  date: 1980-01-02 00:00:00.000000000 Z
11
11
  dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: csv
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '3.2'
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '3.2'
12
26
  - !ruby/object:Gem::Dependency
13
27
  name: google-analytics-admin
14
28
  requirement: !ruby/object:Gem::Requirement
@@ -51,6 +65,20 @@ dependencies:
51
65
  - - "~>"
52
66
  - !ruby/object:Gem::Version
53
67
  version: '1.12'
68
+ - !ruby/object:Gem::Dependency
69
+ name: mcp
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - "~>"
73
+ - !ruby/object:Gem::Version
74
+ version: 0.25.0
75
+ type: :runtime
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - "~>"
80
+ - !ruby/object:Gem::Version
81
+ version: 0.25.0
54
82
  description: |-
55
83
  Analytics Ops provides configuration-as-code, drift detection, explicit
56
84
  plans, safe application, and reporting for Google Analytics 4 properties.
@@ -69,13 +97,17 @@ files:
69
97
  - LICENSE.txt
70
98
  - README.md
71
99
  - SECURITY.md
100
+ - docs/ai-connections.md
72
101
  - docs/api-support-matrix.md
73
102
  - docs/architecture.md
74
103
  - docs/authentication.md
104
+ - docs/bigquery.md
75
105
  - docs/commands.md
76
106
  - docs/configuration-schema-v1.json
77
107
  - docs/configuration.md
78
108
  - docs/google-client-compatibility.md
109
+ - docs/governance.md
110
+ - docs/health.md
79
111
  - docs/live-smoke-test.md
80
112
  - docs/plan-format.md
81
113
  - docs/plan-schema-v1.json
@@ -86,33 +118,60 @@ files:
86
118
  - exe/analytics-ops
87
119
  - lib/analytics_ops.rb
88
120
  - lib/analytics_ops/applier.rb
121
+ - lib/analytics_ops/bigquery.rb
122
+ - lib/analytics_ops/bigquery/definition.rb
89
123
  - lib/analytics_ops/canonical.rb
90
124
  - lib/analytics_ops/cli.rb
125
+ - lib/analytics_ops/cli/local_commands.rb
91
126
  - lib/analytics_ops/cli/options.rb
92
127
  - lib/analytics_ops/cli/presenter.rb
128
+ - lib/analytics_ops/cli/presenter_csv.rb
129
+ - lib/analytics_ops/cli/reporting_commands.rb
130
+ - lib/analytics_ops/cli/setup_commands.rb
93
131
  - lib/analytics_ops/clients/admin.rb
132
+ - lib/analytics_ops/clients/admin_governance.rb
133
+ - lib/analytics_ops/clients/admin_governance_normalization.rb
94
134
  - lib/analytics_ops/clients/admin_normalization.rb
135
+ - lib/analytics_ops/clients/admin_resource_normalization.rb
136
+ - lib/analytics_ops/clients/bigquery.rb
95
137
  - lib/analytics_ops/clients/data.rb
138
+ - lib/analytics_ops/clients/data_result_normalization.rb
96
139
  - lib/analytics_ops/clients/error_translation.rb
97
140
  - lib/analytics_ops/configuration.rb
98
141
  - lib/analytics_ops/configuration/document.rb
99
142
  - lib/analytics_ops/configuration/loader.rb
100
143
  - lib/analytics_ops/configuration/schema.rb
101
144
  - lib/analytics_ops/configuration/validator.rb
145
+ - lib/analytics_ops/configuration/validator_experimental.rb
146
+ - lib/analytics_ops/configuration/validator_reporting.rb
102
147
  - lib/analytics_ops/configuration/writer.rb
103
148
  - lib/analytics_ops/connection.rb
104
149
  - lib/analytics_ops/desired_state.rb
105
150
  - lib/analytics_ops/errors.rb
151
+ - lib/analytics_ops/funnels.rb
152
+ - lib/analytics_ops/governance.rb
153
+ - lib/analytics_ops/health.rb
154
+ - lib/analytics_ops/mcp_server.rb
155
+ - lib/analytics_ops/mcp_server/custom_report_tool.rb
156
+ - lib/analytics_ops/mcp_server/discovery_tools.rb
157
+ - lib/analytics_ops/mcp_server/experimental_tools.rb
158
+ - lib/analytics_ops/mcp_server/health_tools.rb
159
+ - lib/analytics_ops/mcp_server/overview_tools.rb
160
+ - lib/analytics_ops/mcp_server/standard_report_tool.rb
106
161
  - lib/analytics_ops/plan.rb
107
162
  - lib/analytics_ops/planner.rb
163
+ - lib/analytics_ops/portfolio.rb
108
164
  - lib/analytics_ops/rails.rb
109
165
  - lib/analytics_ops/rails/railtie.rb
110
166
  - lib/analytics_ops/redaction.rb
111
167
  - lib/analytics_ops/reports.rb
112
168
  - lib/analytics_ops/reports/catalog.rb
169
+ - lib/analytics_ops/reports/csv_export.rb
113
170
  - lib/analytics_ops/reports/definition.rb
171
+ - lib/analytics_ops/reports/metadata.rb
114
172
  - lib/analytics_ops/reports/overview.rb
115
173
  - lib/analytics_ops/reports/overview_result.rb
174
+ - lib/analytics_ops/reports/period.rb
116
175
  - lib/analytics_ops/reports/result.rb
117
176
  - lib/analytics_ops/resources.rb
118
177
  - lib/analytics_ops/service_account.rb