glancer 1.0.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 (142) hide show
  1. checksums.yaml +7 -0
  2. data/.github/workflows/ci.yml +96 -0
  3. data/.rubocop.yml +54 -0
  4. data/CHANGELOG.md +88 -0
  5. data/CLAUDE.md +115 -0
  6. data/CODE_OF_CONDUCT.md +132 -0
  7. data/README.md +354 -0
  8. data/app/assets/config/glancer_manifest.js +1 -0
  9. data/app/assets/javascripts/glancer/application.js +15 -0
  10. data/app/assets/javascripts/glancer/controllers/chat_controller.js +101 -0
  11. data/app/assets/javascripts/glancer/controllers/message_controller.js +1052 -0
  12. data/app/assets/javascripts/glancer/controllers/toast_controller.js +63 -0
  13. data/app/assets/stylesheets/glancer/application.css +350 -0
  14. data/app/assets/stylesheets/glancer/code-blocks.css +6 -0
  15. data/app/assets/stylesheets/glancer/list.css +31 -0
  16. data/app/assets/stylesheets/glancer/scrollbar.css +16 -0
  17. data/app/assets/stylesheets/glancer/table.css +97 -0
  18. data/app/controllers/glancer/application_controller.rb +33 -0
  19. data/app/controllers/glancer/chats_controller.rb +49 -0
  20. data/app/controllers/glancer/messages_controller.rb +144 -0
  21. data/app/controllers/glancer/schema_controller.rb +29 -0
  22. data/app/controllers/glancer/settings_controller.rb +23 -0
  23. data/app/helpers/glancer/application_helper.rb +17 -0
  24. data/app/jobs/glancer/application_job.rb +6 -0
  25. data/app/jobs/glancer/process_message_job.rb +38 -0
  26. data/app/models/glancer/audit.rb +12 -0
  27. data/app/models/glancer/chat.rb +8 -0
  28. data/app/models/glancer/code_version.rb +12 -0
  29. data/app/models/glancer/embedding.rb +6 -0
  30. data/app/models/glancer/message.rb +25 -0
  31. data/app/models/glancer/setting.rb +23 -0
  32. data/app/models/glancer/sql_version.rb +6 -0
  33. data/app/views/glancer/_data/_importmap.json.erb +7 -0
  34. data/app/views/glancer/chats/_chat_sidebar.html.erb +2 -0
  35. data/app/views/glancer/chats/_show.html.erb +52 -0
  36. data/app/views/glancer/chats/_sidebar_chat_list.html.erb +30 -0
  37. data/app/views/glancer/chats/index.html.erb +10 -0
  38. data/app/views/glancer/chats/show.html.erb +1 -0
  39. data/app/views/glancer/messages/_data_table.html.erb +268 -0
  40. data/app/views/glancer/messages/_execution_error.html.erb +26 -0
  41. data/app/views/glancer/messages/_form.html.erb +93 -0
  42. data/app/views/glancer/messages/_message.html.erb +206 -0
  43. data/app/views/glancer/messages/_message_info.html.erb +176 -0
  44. data/app/views/glancer/messages/_temp_form.html.erb +100 -0
  45. data/app/views/glancer/messages/create.turbo_stream.erb +25 -0
  46. data/app/views/glancer/schema/show.html.erb +123 -0
  47. data/app/views/glancer/settings/show.html.erb +306 -0
  48. data/app/views/glancer/shared/_icons.html.erb +126 -0
  49. data/app/views/layouts/glancer/application.html.erb +234 -0
  50. data/config/locales/glancer.en.yml +90 -0
  51. data/config/locales/glancer.es.yml +90 -0
  52. data/config/locales/glancer.pt-BR.yml +90 -0
  53. data/config/routes.rb +20 -0
  54. data/db/migrate/20250629212642_create_glancer_audits.rb +19 -0
  55. data/db/migrate/20250629212643_create_glancer_chats.rb +10 -0
  56. data/db/migrate/20250629212645_create_glancer_embeddings.rb +17 -0
  57. data/db/migrate/20250629212647_create_glancer_messages.rb +29 -0
  58. data/db/migrate/20260513204129_add_user_edited_sql_to_glancer_messages.rb +11 -0
  59. data/db/migrate/20260513210647_create_glancer_sql_versions.rb +18 -0
  60. data/db/migrate/20260513210648_add_message_id_to_glancer_audits.rb +8 -0
  61. data/db/migrate/20260513220000_create_glancer_settings.rb +12 -0
  62. data/db/migrate/20260514083509_add_llm_model_to_glancer_messages.rb +9 -0
  63. data/db/migrate/20260523120000_rename_code_columns_in_glancer_messages.rb +8 -0
  64. data/db/migrate/20260523120001_rename_code_column_in_glancer_audits.rb +7 -0
  65. data/db/migrate/20260523120002_add_code_type_to_glancer_tables.rb +10 -0
  66. data/db/migrate/20260523120003_rename_glancer_sql_versions_to_code_versions.rb +8 -0
  67. data/db/migrate/20260523130000_add_enriched_question_to_glancer_messages.rb +7 -0
  68. data/db/migrate/20260524100000_add_status_to_glancer_messages.rb +9 -0
  69. data/lib/generators/glancer/install/install_generator.rb +74 -0
  70. data/lib/generators/glancer/install/templates/glancer.rb +227 -0
  71. data/lib/generators/glancer/install/templates/llm_context.glancer.md +51 -0
  72. data/lib/glancer/async_runner.rb +50 -0
  73. data/lib/glancer/chart_analyzer.rb +230 -0
  74. data/lib/glancer/configuration.rb +372 -0
  75. data/lib/glancer/engine.rb +90 -0
  76. data/lib/glancer/indexer/context_indexer.rb +58 -0
  77. data/lib/glancer/indexer/model_indexer.rb +64 -0
  78. data/lib/glancer/indexer/schema_indexer.rb +171 -0
  79. data/lib/glancer/indexer.rb +50 -0
  80. data/lib/glancer/retriever.rb +114 -0
  81. data/lib/glancer/utils/logger.rb +83 -0
  82. data/lib/glancer/utils/markdown_helper.rb +56 -0
  83. data/lib/glancer/utils/result_formatter.rb +25 -0
  84. data/lib/glancer/utils/table_stats.rb +18 -0
  85. data/lib/glancer/utils/transaction.rb +59 -0
  86. data/lib/glancer/version.rb +5 -0
  87. data/lib/glancer/workflow/ar_executor.rb +104 -0
  88. data/lib/glancer/workflow/ar_extractor.rb +25 -0
  89. data/lib/glancer/workflow/ar_prompt_builder.rb +64 -0
  90. data/lib/glancer/workflow/ar_sanitizer.rb +88 -0
  91. data/lib/glancer/workflow/builder.rb +129 -0
  92. data/lib/glancer/workflow/cache.rb +55 -0
  93. data/lib/glancer/workflow/executor.rb +72 -0
  94. data/lib/glancer/workflow/llm.rb +123 -0
  95. data/lib/glancer/workflow/prompt_builder.rb +143 -0
  96. data/lib/glancer/workflow/query_enricher.rb +117 -0
  97. data/lib/glancer/workflow/sql_extractor.rb +42 -0
  98. data/lib/glancer/workflow/sql_sanitizer.rb +42 -0
  99. data/lib/glancer/workflow/sql_validator.rb +67 -0
  100. data/lib/glancer/workflow.rb +158 -0
  101. data/lib/glancer.rb +50 -0
  102. data/lib/tasks/glancer/tailwind.rake +8 -0
  103. data/lib/tasks/glancer.rake +99 -0
  104. data/spec/glancer_spec.rb +62 -0
  105. data/spec/lib/glancer/async_runner_spec.rb +133 -0
  106. data/spec/lib/glancer/chart_analyzer_spec.rb +296 -0
  107. data/spec/lib/glancer/configuration_spec.rb +858 -0
  108. data/spec/lib/glancer/engine_spec.rb +209 -0
  109. data/spec/lib/glancer/indexer/context_indexer_spec.rb +96 -0
  110. data/spec/lib/glancer/indexer/model_indexer_spec.rb +103 -0
  111. data/spec/lib/glancer/indexer/schema_indexer_spec.rb +382 -0
  112. data/spec/lib/glancer/indexer_spec.rb +95 -0
  113. data/spec/lib/glancer/retriever_spec.rb +179 -0
  114. data/spec/lib/glancer/utils/logger_spec.rb +85 -0
  115. data/spec/lib/glancer/utils/markdown_helper_spec.rb +92 -0
  116. data/spec/lib/glancer/utils/result_formatter_spec.rb +73 -0
  117. data/spec/lib/glancer/utils/table_stats_spec.rb +34 -0
  118. data/spec/lib/glancer/utils/transaction_spec.rb +73 -0
  119. data/spec/lib/glancer/workflow/ar_executor_spec.rb +155 -0
  120. data/spec/lib/glancer/workflow/ar_extractor_spec.rb +50 -0
  121. data/spec/lib/glancer/workflow/ar_prompt_builder_spec.rb +79 -0
  122. data/spec/lib/glancer/workflow/ar_sanitizer_spec.rb +175 -0
  123. data/spec/lib/glancer/workflow/builder_spec.rb +204 -0
  124. data/spec/lib/glancer/workflow/cache_spec.rb +142 -0
  125. data/spec/lib/glancer/workflow/executor_spec.rb +149 -0
  126. data/spec/lib/glancer/workflow/llm_spec.rb +124 -0
  127. data/spec/lib/glancer/workflow/prompt_builder_spec.rb +196 -0
  128. data/spec/lib/glancer/workflow/query_enricher_spec.rb +184 -0
  129. data/spec/lib/glancer/workflow/sql_extractor_spec.rb +82 -0
  130. data/spec/lib/glancer/workflow/sql_sanitizer_spec.rb +98 -0
  131. data/spec/lib/glancer/workflow/sql_validator_spec.rb +166 -0
  132. data/spec/lib/glancer/workflow_spec.rb +308 -0
  133. data/spec/models/glancer/audit_spec.rb +82 -0
  134. data/spec/models/glancer/chat_spec.rb +60 -0
  135. data/spec/models/glancer/code_version_spec.rb +71 -0
  136. data/spec/models/glancer/embedding_spec.rb +73 -0
  137. data/spec/models/glancer/message_spec.rb +144 -0
  138. data/spec/models/glancer/setting_spec.rb +88 -0
  139. data/spec/models/glancer/sql_version_spec.rb +4 -0
  140. data/spec/spec_helper.rb +128 -0
  141. data/spec/support/schema.rb +55 -0
  142. metadata +255 -0
metadata ADDED
@@ -0,0 +1,255 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: glancer
3
+ version: !ruby/object:Gem::Version
4
+ version: 1.0.0
5
+ platform: ruby
6
+ authors:
7
+ - Ernane Ferreira
8
+ bindir: exe
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: commonmarker
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '2.8'
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '2.8'
26
+ - !ruby/object:Gem::Dependency
27
+ name: rails
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - ">="
31
+ - !ruby/object:Gem::Version
32
+ version: '7.0'
33
+ type: :runtime
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - ">="
38
+ - !ruby/object:Gem::Version
39
+ version: '7.0'
40
+ - !ruby/object:Gem::Dependency
41
+ name: ruby_llm
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - "~>"
45
+ - !ruby/object:Gem::Version
46
+ version: '1.15'
47
+ type: :runtime
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - "~>"
52
+ - !ruby/object:Gem::Version
53
+ version: '1.15'
54
+ - !ruby/object:Gem::Dependency
55
+ name: stimulus-rails
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - ">="
59
+ - !ruby/object:Gem::Version
60
+ version: '1.0'
61
+ type: :runtime
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - ">="
66
+ - !ruby/object:Gem::Version
67
+ version: '1.0'
68
+ - !ruby/object:Gem::Dependency
69
+ name: turbo-rails
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - ">="
73
+ - !ruby/object:Gem::Version
74
+ version: '0.7'
75
+ type: :runtime
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - ">="
80
+ - !ruby/object:Gem::Version
81
+ version: '0.7'
82
+ description: Glancer is a Ruby on Rails engine that enables natural language queries
83
+ over your database using RAG and LLMs.
84
+ email:
85
+ - ernane.junior25@gmail.com
86
+ executables: []
87
+ extensions: []
88
+ extra_rdoc_files: []
89
+ files:
90
+ - ".github/workflows/ci.yml"
91
+ - ".rubocop.yml"
92
+ - CHANGELOG.md
93
+ - CLAUDE.md
94
+ - CODE_OF_CONDUCT.md
95
+ - README.md
96
+ - app/assets/config/glancer_manifest.js
97
+ - app/assets/javascripts/glancer/application.js
98
+ - app/assets/javascripts/glancer/controllers/chat_controller.js
99
+ - app/assets/javascripts/glancer/controllers/message_controller.js
100
+ - app/assets/javascripts/glancer/controllers/toast_controller.js
101
+ - app/assets/stylesheets/glancer/application.css
102
+ - app/assets/stylesheets/glancer/code-blocks.css
103
+ - app/assets/stylesheets/glancer/list.css
104
+ - app/assets/stylesheets/glancer/scrollbar.css
105
+ - app/assets/stylesheets/glancer/table.css
106
+ - app/controllers/glancer/application_controller.rb
107
+ - app/controllers/glancer/chats_controller.rb
108
+ - app/controllers/glancer/messages_controller.rb
109
+ - app/controllers/glancer/schema_controller.rb
110
+ - app/controllers/glancer/settings_controller.rb
111
+ - app/helpers/glancer/application_helper.rb
112
+ - app/jobs/glancer/application_job.rb
113
+ - app/jobs/glancer/process_message_job.rb
114
+ - app/models/glancer/audit.rb
115
+ - app/models/glancer/chat.rb
116
+ - app/models/glancer/code_version.rb
117
+ - app/models/glancer/embedding.rb
118
+ - app/models/glancer/message.rb
119
+ - app/models/glancer/setting.rb
120
+ - app/models/glancer/sql_version.rb
121
+ - app/views/glancer/_data/_importmap.json.erb
122
+ - app/views/glancer/chats/_chat_sidebar.html.erb
123
+ - app/views/glancer/chats/_show.html.erb
124
+ - app/views/glancer/chats/_sidebar_chat_list.html.erb
125
+ - app/views/glancer/chats/index.html.erb
126
+ - app/views/glancer/chats/show.html.erb
127
+ - app/views/glancer/messages/_data_table.html.erb
128
+ - app/views/glancer/messages/_execution_error.html.erb
129
+ - app/views/glancer/messages/_form.html.erb
130
+ - app/views/glancer/messages/_message.html.erb
131
+ - app/views/glancer/messages/_message_info.html.erb
132
+ - app/views/glancer/messages/_temp_form.html.erb
133
+ - app/views/glancer/messages/create.turbo_stream.erb
134
+ - app/views/glancer/schema/show.html.erb
135
+ - app/views/glancer/settings/show.html.erb
136
+ - app/views/glancer/shared/_icons.html.erb
137
+ - app/views/layouts/glancer/application.html.erb
138
+ - config/locales/glancer.en.yml
139
+ - config/locales/glancer.es.yml
140
+ - config/locales/glancer.pt-BR.yml
141
+ - config/routes.rb
142
+ - db/migrate/20250629212642_create_glancer_audits.rb
143
+ - db/migrate/20250629212643_create_glancer_chats.rb
144
+ - db/migrate/20250629212645_create_glancer_embeddings.rb
145
+ - db/migrate/20250629212647_create_glancer_messages.rb
146
+ - db/migrate/20260513204129_add_user_edited_sql_to_glancer_messages.rb
147
+ - db/migrate/20260513210647_create_glancer_sql_versions.rb
148
+ - db/migrate/20260513210648_add_message_id_to_glancer_audits.rb
149
+ - db/migrate/20260513220000_create_glancer_settings.rb
150
+ - db/migrate/20260514083509_add_llm_model_to_glancer_messages.rb
151
+ - db/migrate/20260523120000_rename_code_columns_in_glancer_messages.rb
152
+ - db/migrate/20260523120001_rename_code_column_in_glancer_audits.rb
153
+ - db/migrate/20260523120002_add_code_type_to_glancer_tables.rb
154
+ - db/migrate/20260523120003_rename_glancer_sql_versions_to_code_versions.rb
155
+ - db/migrate/20260523130000_add_enriched_question_to_glancer_messages.rb
156
+ - db/migrate/20260524100000_add_status_to_glancer_messages.rb
157
+ - lib/generators/glancer/install/install_generator.rb
158
+ - lib/generators/glancer/install/templates/glancer.rb
159
+ - lib/generators/glancer/install/templates/llm_context.glancer.md
160
+ - lib/glancer.rb
161
+ - lib/glancer/async_runner.rb
162
+ - lib/glancer/chart_analyzer.rb
163
+ - lib/glancer/configuration.rb
164
+ - lib/glancer/engine.rb
165
+ - lib/glancer/indexer.rb
166
+ - lib/glancer/indexer/context_indexer.rb
167
+ - lib/glancer/indexer/model_indexer.rb
168
+ - lib/glancer/indexer/schema_indexer.rb
169
+ - lib/glancer/retriever.rb
170
+ - lib/glancer/utils/logger.rb
171
+ - lib/glancer/utils/markdown_helper.rb
172
+ - lib/glancer/utils/result_formatter.rb
173
+ - lib/glancer/utils/table_stats.rb
174
+ - lib/glancer/utils/transaction.rb
175
+ - lib/glancer/version.rb
176
+ - lib/glancer/workflow.rb
177
+ - lib/glancer/workflow/ar_executor.rb
178
+ - lib/glancer/workflow/ar_extractor.rb
179
+ - lib/glancer/workflow/ar_prompt_builder.rb
180
+ - lib/glancer/workflow/ar_sanitizer.rb
181
+ - lib/glancer/workflow/builder.rb
182
+ - lib/glancer/workflow/cache.rb
183
+ - lib/glancer/workflow/executor.rb
184
+ - lib/glancer/workflow/llm.rb
185
+ - lib/glancer/workflow/prompt_builder.rb
186
+ - lib/glancer/workflow/query_enricher.rb
187
+ - lib/glancer/workflow/sql_extractor.rb
188
+ - lib/glancer/workflow/sql_sanitizer.rb
189
+ - lib/glancer/workflow/sql_validator.rb
190
+ - lib/tasks/glancer.rake
191
+ - lib/tasks/glancer/tailwind.rake
192
+ - spec/glancer_spec.rb
193
+ - spec/lib/glancer/async_runner_spec.rb
194
+ - spec/lib/glancer/chart_analyzer_spec.rb
195
+ - spec/lib/glancer/configuration_spec.rb
196
+ - spec/lib/glancer/engine_spec.rb
197
+ - spec/lib/glancer/indexer/context_indexer_spec.rb
198
+ - spec/lib/glancer/indexer/model_indexer_spec.rb
199
+ - spec/lib/glancer/indexer/schema_indexer_spec.rb
200
+ - spec/lib/glancer/indexer_spec.rb
201
+ - spec/lib/glancer/retriever_spec.rb
202
+ - spec/lib/glancer/utils/logger_spec.rb
203
+ - spec/lib/glancer/utils/markdown_helper_spec.rb
204
+ - spec/lib/glancer/utils/result_formatter_spec.rb
205
+ - spec/lib/glancer/utils/table_stats_spec.rb
206
+ - spec/lib/glancer/utils/transaction_spec.rb
207
+ - spec/lib/glancer/workflow/ar_executor_spec.rb
208
+ - spec/lib/glancer/workflow/ar_extractor_spec.rb
209
+ - spec/lib/glancer/workflow/ar_prompt_builder_spec.rb
210
+ - spec/lib/glancer/workflow/ar_sanitizer_spec.rb
211
+ - spec/lib/glancer/workflow/builder_spec.rb
212
+ - spec/lib/glancer/workflow/cache_spec.rb
213
+ - spec/lib/glancer/workflow/executor_spec.rb
214
+ - spec/lib/glancer/workflow/llm_spec.rb
215
+ - spec/lib/glancer/workflow/prompt_builder_spec.rb
216
+ - spec/lib/glancer/workflow/query_enricher_spec.rb
217
+ - spec/lib/glancer/workflow/sql_extractor_spec.rb
218
+ - spec/lib/glancer/workflow/sql_sanitizer_spec.rb
219
+ - spec/lib/glancer/workflow/sql_validator_spec.rb
220
+ - spec/lib/glancer/workflow_spec.rb
221
+ - spec/models/glancer/audit_spec.rb
222
+ - spec/models/glancer/chat_spec.rb
223
+ - spec/models/glancer/code_version_spec.rb
224
+ - spec/models/glancer/embedding_spec.rb
225
+ - spec/models/glancer/message_spec.rb
226
+ - spec/models/glancer/setting_spec.rb
227
+ - spec/models/glancer/sql_version_spec.rb
228
+ - spec/spec_helper.rb
229
+ - spec/support/schema.rb
230
+ homepage: https://github.com/ernanej/glancer
231
+ licenses:
232
+ - MIT
233
+ metadata:
234
+ allowed_push_host: https://rubygems.org
235
+ homepage_uri: https://github.com/ernanej/glancer
236
+ source_code_uri: https://github.com/ernanej/glancer
237
+ changelog_uri: https://github.com/ernanej/glancer/blob/main/CHANGELOG.md
238
+ rdoc_options: []
239
+ require_paths:
240
+ - lib
241
+ required_ruby_version: !ruby/object:Gem::Requirement
242
+ requirements:
243
+ - - ">="
244
+ - !ruby/object:Gem::Version
245
+ version: 3.3.0
246
+ required_rubygems_version: !ruby/object:Gem::Requirement
247
+ requirements:
248
+ - - ">="
249
+ - !ruby/object:Gem::Version
250
+ version: '0'
251
+ requirements: []
252
+ rubygems_version: 4.0.10
253
+ specification_version: 4
254
+ summary: RAG-driven AI interface for querying Rails databases
255
+ test_files: []