aia 2.0.0.0.pre.beta2 → 2.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 (225) hide show
  1. checksums.yaml +4 -4
  2. data/.version +1 -1
  3. data/CHANGELOG.md +146 -228
  4. data/README.md +41 -18
  5. data/bin/aia +8 -3
  6. data/lib/aia/aia_completion.bash +2 -3
  7. data/lib/aia/aia_completion.fish +6 -5
  8. data/lib/aia/aia_completion.zsh +2 -3
  9. data/lib/aia/chat_loop.rb +16 -14
  10. data/lib/aia/config/cli_parser.rb +123 -91
  11. data/lib/aia/config/defaults.yml +12 -39
  12. data/lib/aia/config/mcp_parser.rb +30 -36
  13. data/lib/aia/config/model_spec.rb +8 -14
  14. data/lib/aia/config/validator.rb +102 -103
  15. data/lib/aia/config/value_caster.rb +76 -0
  16. data/lib/aia/config.rb +70 -53
  17. data/lib/aia/crew.rb +29 -19
  18. data/lib/aia/debate_handler.rb +27 -10
  19. data/lib/aia/directives/configuration_directives.rb +55 -14
  20. data/lib/aia/directives/context_directives.rb +24 -12
  21. data/lib/aia/directives/execution_directives.rb +18 -23
  22. data/lib/aia/directives/model_directives.rb +41 -104
  23. data/lib/aia/directives/utility_directives.rb +16 -17
  24. data/lib/aia/directives/web_and_file_directives.rb +21 -14
  25. data/lib/aia/fact_asserter.rb +3 -3
  26. data/lib/aia/history_transfer.rb +64 -24
  27. data/lib/aia/logger.rb +10 -45
  28. data/lib/aia/mcp_config_normalizer.rb +27 -14
  29. data/lib/aia/mcp_connection_manager.rb +181 -184
  30. data/lib/aia/mcp_discovery.rb +43 -15
  31. data/lib/aia/mcp_grouper.rb +2 -1
  32. data/lib/aia/mcp_server_config.rb +20 -2
  33. data/lib/aia/mcp_utility.rb +24 -19
  34. data/lib/aia/mention_router.rb +15 -2
  35. data/lib/aia/modality_query.rb +36 -0
  36. data/lib/aia/model_alias_registry.rb +11 -11
  37. data/lib/aia/model_registry.rb +75 -0
  38. data/lib/aia/network_builder.rb +8 -7
  39. data/lib/aia/patches/ruby_llm_streaming_error.rb +21 -4
  40. data/lib/aia/patches/ruby_llm_tool_param_compat.rb +18 -0
  41. data/lib/aia/pipeline_orchestrator.rb +71 -38
  42. data/lib/aia/prompt_decomposer.rb +1 -1
  43. data/lib/aia/prompt_handler.rb +56 -29
  44. data/lib/aia/provider_registry.rb +105 -0
  45. data/lib/aia/robot_builder.rb +1 -1
  46. data/lib/aia/robot_factory.rb +67 -63
  47. data/lib/aia/robot_sync.rb +79 -0
  48. data/lib/aia/role_catalog.rb +89 -0
  49. data/lib/aia/session.rb +25 -11
  50. data/lib/aia/skill_utils.rb +60 -19
  51. data/lib/aia/spawn_handler.rb +16 -4
  52. data/lib/aia/spawn_spec_parser.rb +6 -7
  53. data/lib/aia/special_mode_handler.rb +28 -25
  54. data/lib/aia/speech.rb +70 -34
  55. data/lib/aia/startup_coordinator.rb +17 -92
  56. data/lib/aia/streaming_runner.rb +10 -2
  57. data/lib/aia/system_prompt_assembler.rb +12 -11
  58. data/lib/aia/task_board.rb +60 -0
  59. data/lib/aia/tool_approver.rb +205 -0
  60. data/lib/aia/tool_filter.rb +1 -10
  61. data/lib/aia/tool_filter_strategy.rb +12 -1
  62. data/lib/aia/tool_introspection.rb +9 -1
  63. data/lib/aia/tool_loader.rb +67 -33
  64. data/lib/aia/tool_utility.rb +6 -5
  65. data/lib/aia/tools/delegate_to_foreman_tool.rb +6 -4
  66. data/lib/aia/tools/recruit_robot_tool.rb +12 -12
  67. data/lib/aia/tools/reskill_robot_tool.rb +7 -7
  68. data/lib/aia/tools/task_board_tool.rb +16 -16
  69. data/lib/aia/trakflow_bridge.rb +14 -8
  70. data/lib/aia/turn_state.rb +31 -8
  71. data/lib/aia/ui_presenter.rb +16 -0
  72. data/lib/aia/utility.rb +6 -24
  73. data/lib/aia/variable_input_collector.rb +0 -3
  74. data/lib/aia/verification_network.rb +9 -10
  75. data/lib/aia.rb +33 -8
  76. metadata +19 -160
  77. data/.better-commits.json +0 -150
  78. data/.config/tocer/configuration.yml +0 -6
  79. data/.envrc +0 -19
  80. data/.loki +0 -11
  81. data/.reek.yml +0 -160
  82. data/.rubocop.yml +0 -116
  83. data/.rubocop_strict.yml +0 -15
  84. data/COMMITS.md +0 -196
  85. data/IMPLEMENTATION_PLAN.md +0 -506
  86. data/Rakefile +0 -47
  87. data/_typos.toml +0 -10
  88. data/aia.gemspec +0 -92
  89. data/architecture_review.md +0 -314
  90. data/config/aia.yml +0 -13
  91. data/docs/AGENTS.md +0 -40
  92. data/docs/advanced-prompting.md +0 -814
  93. data/docs/assets/images/aia.png +0 -0
  94. data/docs/cli-reference.md +0 -1241
  95. data/docs/configuration.md +0 -747
  96. data/docs/contributing.md +0 -386
  97. data/docs/directives-reference.md +0 -1145
  98. data/docs/examples/index.md +0 -277
  99. data/docs/examples/mcp/index.md +0 -475
  100. data/docs/examples/prompts/analysis/index.md +0 -78
  101. data/docs/examples/prompts/automation/index.md +0 -109
  102. data/docs/examples/prompts/development/index.md +0 -125
  103. data/docs/examples/prompts/index.md +0 -333
  104. data/docs/examples/prompts/learning/index.md +0 -127
  105. data/docs/examples/prompts/writing/index.md +0 -62
  106. data/docs/examples/tools/index.md +0 -282
  107. data/docs/faq.md +0 -578
  108. data/docs/guides/available-models.md +0 -366
  109. data/docs/guides/basic-usage.md +0 -478
  110. data/docs/guides/chat.md +0 -680
  111. data/docs/guides/crew.md +0 -239
  112. data/docs/guides/executable-prompts.md +0 -331
  113. data/docs/guides/first-prompt.md +0 -454
  114. data/docs/guides/getting-started.md +0 -455
  115. data/docs/guides/image-generation.md +0 -507
  116. data/docs/guides/index.md +0 -48
  117. data/docs/guides/local-models.md +0 -306
  118. data/docs/guides/migrate-prompts.md +0 -335
  119. data/docs/guides/models.md +0 -1017
  120. data/docs/guides/shared-tools.md +0 -254
  121. data/docs/guides/tools.md +0 -831
  122. data/docs/index.md +0 -259
  123. data/docs/installation.md +0 -274
  124. data/docs/mcp-integration.md +0 -603
  125. data/docs/prompt_management.md +0 -665
  126. data/docs/security.md +0 -674
  127. data/docs/special_projects_guide.md +0 -386
  128. data/docs/tools-and-mcp-examples.md +0 -1211
  129. data/docs/workflows-and-pipelines.md +0 -636
  130. data/examples/.gitignore +0 -2
  131. data/examples/00_setup_aia.sh +0 -111
  132. data/examples/01_basic_usage.sh +0 -23
  133. data/examples/02_frontmatter.sh +0 -33
  134. data/examples/03_shell_integration.sh +0 -55
  135. data/examples/04_erb_templating.sh +0 -56
  136. data/examples/05_shell_then_erb.sh +0 -38
  137. data/examples/06_prompt_chaining.sh +0 -59
  138. data/examples/07_pipeline.sh +0 -46
  139. data/examples/08_context_files.sh +0 -43
  140. data/examples/09_roles.sh +0 -67
  141. data/examples/10_stdin_piping.sh +0 -49
  142. data/examples/11_multi_model.sh +0 -65
  143. data/examples/12_token_usage.sh +0 -52
  144. data/examples/13_cost_tracking.sh +0 -68
  145. data/examples/14_output_file.sh +0 -91
  146. data/examples/15_parameters.sh +0 -68
  147. data/examples/16_directives.sh +0 -113
  148. data/examples/17_require_and_conditionals.sh +0 -68
  149. data/examples/18_tools.sh +0 -61
  150. data/examples/19_local_tools.sh +0 -34
  151. data/examples/20_mcp_servers.sh +0 -102
  152. data/examples/21_executable_prompts.sh +0 -78
  153. data/examples/22_chat_mode.sh +0 -217
  154. data/examples/23_verify.sh +0 -139
  155. data/examples/24_decompose.sh +0 -139
  156. data/examples/25_spawn.sh +0 -139
  157. data/examples/26_debate.sh +0 -97
  158. data/examples/27_mention_routing.sh +0 -157
  159. data/examples/28_model_switching.sh +0 -106
  160. data/examples/29_agent_harness.sh +0 -177
  161. data/examples/README.md +0 -321
  162. data/examples/advanced_multi_robot_capabilities_without_examples.md +0 -106
  163. data/examples/aia_config.yml +0 -22
  164. data/examples/aia_config_orchestrator.yml +0 -45
  165. data/examples/aia_config_with_mcp.yml +0 -21
  166. data/examples/common.sh +0 -39
  167. data/examples/context/project_goals.md +0 -6
  168. data/examples/context/tech_stack.md +0 -7
  169. data/examples/directives/timestamp_directive.rb +0 -22
  170. data/examples/mcp/filesystem.json +0 -9
  171. data/examples/prompts_dir/analyze.md +0 -2
  172. data/examples/prompts_dir/brainstorm.md +0 -2
  173. data/examples/prompts_dir/conditional.md +0 -17
  174. data/examples/prompts_dir/creative.md +0 -4
  175. data/examples/prompts_dir/erbinfo.md +0 -5
  176. data/examples/prompts_dir/erbinfo_raw.md +0 -8
  177. data/examples/prompts_dir/evaluate.md +0 -2
  178. data/examples/prompts_dir/explain_joke.md +0 -1
  179. data/examples/prompts_dir/explain_recursion.md +0 -1
  180. data/examples/prompts_dir/fun_fact +0 -3
  181. data/examples/prompts_dir/greeting.md +0 -8
  182. data/examples/prompts_dir/greeting_required.md +0 -7
  183. data/examples/prompts_dir/hello.md +0 -1
  184. data/examples/prompts_dir/includes/ruby_facts.md +0 -4
  185. data/examples/prompts_dir/limerick.md +0 -1
  186. data/examples/prompts_dir/list_with_mcp.md +0 -3
  187. data/examples/prompts_dir/pick_best.md +0 -2
  188. data/examples/prompts_dir/project_summary +0 -12
  189. data/examples/prompts_dir/quiz_with_include.md +0 -6
  190. data/examples/prompts_dir/require_demo.md +0 -5
  191. data/examples/prompts_dir/roles/formal.md +0 -3
  192. data/examples/prompts_dir/roles/orchestrator.md +0 -21
  193. data/examples/prompts_dir/roles/pirate.md +0 -3
  194. data/examples/prompts_dir/shell_then_erb.md +0 -6
  195. data/examples/prompts_dir/sort_compare.md +0 -2
  196. data/examples/prompts_dir/summarize_context.md +0 -2
  197. data/examples/prompts_dir/sysinfo.md +0 -5
  198. data/examples/prompts_dir/sysinfo_raw.md +0 -8
  199. data/examples/prompts_dir/tagline.md +0 -1
  200. data/examples/prompts_dir/tell_joke.md +0 -1
  201. data/examples/prompts_dir/tell_joke_with_next.md +0 -4
  202. data/examples/prompts_dir/use_local_tool.md +0 -8
  203. data/examples/prompts_dir/use_tools.md +0 -8
  204. data/examples/prompts_dir/weather.md +0 -2
  205. data/examples/prompts_dir/whats_new.md +0 -2
  206. data/examples/prompts_dir/with_timestamp.md +0 -5
  207. data/examples/requirements/sinatra_taskflow_app.md +0 -139
  208. data/examples/rules/01_classify_ruby.rb +0 -16
  209. data/examples/rules/02_prefer_claude_for_code.rb +0 -19
  210. data/examples/rules/03_gate_prompt_length.rb +0 -19
  211. data/examples/rules/04_tool_selection.rb +0 -41
  212. data/examples/rules/README.md +0 -30
  213. data/examples/run_all.sh +0 -294
  214. data/examples/tools/word_count_tool.rb +0 -30
  215. data/lib/AGENTS.md +0 -57
  216. data/lib/aia/model_switch_handler.rb +0 -100
  217. data/mcp_servers/README.md +0 -110
  218. data/mcp_servers/apple-mcp.json +0 -8
  219. data/mcp_servers/filesystem.json +0 -9
  220. data/mcp_servers/mcp_server_chart.json +0 -11
  221. data/mcp_servers/playwright_one.json +0 -8
  222. data/mcp_servers/playwright_server_definition.json +0 -9
  223. data/mcp_servers/playwright_two.json +0 -8
  224. data/mcp_servers/tavily_mcp_server.json +0 -8
  225. data/mkdocs.yml +0 -169
data/docs/contributing.md DELETED
@@ -1,386 +0,0 @@
1
- <!-- Tocer[start]: Auto-generated, don't remove. -->
2
-
3
- ## Table of Contents
4
-
5
- - [Contributing to AIA](#contributing-to-aia)
6
- - [Ways to Contribute](#ways-to-contribute)
7
- - [1. Report Issues](#1-report-issues)
8
- - [2. Submit Code Changes](#2-submit-code-changes)
9
- - [3. Improve Documentation](#3-improve-documentation)
10
- - [4. Contribute Examples](#4-contribute-examples)
11
- - [Getting Started](#getting-started)
12
- - [Prerequisites](#prerequisites)
13
- - [Setting Up Development Environment](#setting-up-development-environment)
14
- - [Development Guidelines](#development-guidelines)
15
- - [Code Standards](#code-standards)
16
- - [Ruby Style Guide](#ruby-style-guide)
17
- - [Testing Requirements](#testing-requirements)
18
- - [Documentation Standards](#documentation-standards)
19
- - [Commit Message Format](#commit-message-format)
20
- - [Contributing Examples](#contributing-examples)
21
- - [Prompt Examples](#prompt-examples)
22
- - [File Structure](#file-structure)
23
- - [Prompt Template Format](#prompt-template-format)
24
- - [Tool Examples](#tool-examples)
25
- - [File Structure](#file-structure-1)
26
- - [Tool Template](#tool-template)
27
- - [MCP Client Examples](#mcp-client-examples)
28
- - [File Structure](#file-structure-2)
29
- - [Pull Request Process](#pull-request-process)
30
- - [Before Submitting](#before-submitting)
31
- - [Submitting the Pull Request](#submitting-the-pull-request)
32
- - [Review Process](#review-process)
33
- - [Community Guidelines](#community-guidelines)
34
- - [Communication](#communication)
35
- - [Issue Reporting](#issue-reporting)
36
- - [Feature Requests](#feature-requests)
37
- - [Security](#security)
38
- - [Reporting Security Issues](#reporting-security-issues)
39
- - [Security Best Practices](#security-best-practices)
40
- - [Recognition](#recognition)
41
- - [Contributors](#contributors)
42
- - [Types of Recognition](#types-of-recognition)
43
- - [Getting Help](#getting-help)
44
- - [Development Questions](#development-questions)
45
- - [Code Review](#code-review)
46
- - [Community Support](#community-support)
47
- - [Release Process](#release-process)
48
- - [Version Management](#version-management)
49
- - [Release Schedule](#release-schedule)
50
- - [Thank You!](#thank-you)
51
-
52
- <!-- Tocer[finish]: Auto-generated, don't remove. -->
53
-
54
- # Contributing to AIA
55
-
56
- We welcome contributions to AIA! This guide will help you get started with contributing to the project.
57
-
58
- ## Ways to Contribute
59
-
60
- ### 1. Report Issues
61
- - **Bug Reports**: Found a bug? Please report it with detailed steps to reproduce
62
- - **Feature Requests**: Have an idea for a new feature? We'd love to hear about it
63
- - **Documentation Issues**: Spot errors or areas for improvement in documentation
64
-
65
- ### 2. Submit Code Changes
66
- - **Bug Fixes**: Help fix reported issues
67
- - **New Features**: Implement requested features or propose new ones
68
- - **Performance Improvements**: Optimize existing code
69
- - **Tests**: Improve test coverage and quality
70
-
71
- ### 3. Improve Documentation
72
- - **User Guides**: Help improve user-facing documentation
73
- - **Code Comments**: Add or improve inline documentation
74
- - **Examples**: Contribute new examples or improve existing ones
75
- - **Tutorials**: Create learning materials for new users
76
-
77
- ### 4. Contribute Examples
78
- - **Prompts**: Share useful prompt templates
79
- - **Tools**: Create Ruby tools that extend AIA's capabilities
80
- - **MCP Clients**: Develop Model Context Protocol integrations
81
-
82
- ## Getting Started
83
-
84
- ### Prerequisites
85
- - Ruby >= 4.0.0 installed
86
- - Git for version control
87
- - Familiarity with AI/LLM concepts
88
- - Understanding of command-line tools
89
-
90
- ### Setting Up Development Environment
91
-
92
- 1. **Fork and Clone**
93
- ```bash
94
- git clone https://github.com/your-username/aia.git
95
- cd aia
96
- ```
97
-
98
- 2. **Install Dependencies**
99
- ```bash
100
- bundle install
101
- ```
102
-
103
- 3. **Run Tests**
104
- ```bash
105
- rake test
106
- ```
107
-
108
- 4. **Create Feature Branch**
109
- ```bash
110
- git checkout -b feature/your-feature-name
111
- ```
112
-
113
- ## Development Guidelines
114
-
115
- ### Code Standards
116
-
117
- #### Ruby Style Guide
118
- - Follow Ruby community conventions
119
- - Use descriptive variable and method names
120
- - Write clear, concise comments
121
- - Maintain consistent indentation (2 spaces)
122
- - Keep line length under 120 characters
123
-
124
- #### Testing Requirements
125
- - Write tests for all new functionality
126
- - Maintain or improve test coverage
127
- - Use descriptive test names
128
- - Include both unit and integration tests
129
-
130
- #### Documentation Standards
131
- - Update README if needed
132
- - Add inline documentation for public methods
133
- - Include usage examples
134
- - Update CHANGELOG.md for user-facing changes
135
-
136
- ### Commit Message Format
137
-
138
- Use clear, descriptive commit messages following this format:
139
-
140
- ```
141
- type(scope): brief description
142
-
143
- Longer description if needed
144
-
145
- - List key changes
146
- - Include breaking changes
147
- - Reference issues: Fixes #123
148
- ```
149
-
150
- **Types:**
151
- - `feat`: New feature
152
- - `fix`: Bug fix
153
- - `docs`: Documentation changes
154
- - `test`: Test-related changes
155
- - `refactor`: Code refactoring
156
- - `perf`: Performance improvements
157
-
158
- **Examples:**
159
- ```
160
- feat(cli): add --fuzzy flag for prompt selection
161
-
162
- fix(config): resolve issue with nested YAML parsing
163
-
164
- docs(examples): add MCP client integration examples
165
- ```
166
-
167
- ## Contributing Examples
168
-
169
- ### Prompt Examples
170
-
171
- #### File Structure
172
- ```
173
- docs/examples/prompts/category/
174
- ├── index.md # Category overview
175
- ├── example_name.md # Prompt file
176
- └── example_name_usage.md # Usage documentation
177
- ```
178
-
179
- #### Prompt Template Format
180
- ```markdown
181
- # Prompt Title
182
-
183
- Brief description of what this prompt does.
184
-
185
- ## Prerequisites
186
- - List any required setup
187
- - Dependencies or tools needed
188
- - API keys or configurations
189
-
190
- ## Usage
191
- ```bash
192
- aia prompt_name input_file.txt
193
- ```
194
-
195
- ## Customization
196
- Explain how users can modify the prompt for their needs.
197
-
198
- ## Related Examples
199
- - Link to similar or complementary examples
200
- ```
201
-
202
- ### Tool Examples
203
-
204
- #### File Structure
205
- ```
206
- docs/examples/tools/
207
- ├── index.md # Tools overview
208
- ├── tool_name.rb # Ruby tool implementation
209
- └── tool_name_usage.md # Documentation
210
- ```
211
-
212
- #### Tool Template
213
- ```ruby
214
- # Tool implementation following RubyLLM::Tool pattern
215
- class ToolName < RubyLLM::Tool
216
- description "Brief description of tool functionality"
217
-
218
- def method_name(parameter1, parameter2 = nil)
219
- # Implementation with error handling
220
- # Return structured results
221
- end
222
-
223
- private
224
-
225
- def helper_method
226
- # Internal helper methods
227
- end
228
- end
229
- ```
230
-
231
- ### MCP Client Examples
232
-
233
- #### File Structure
234
- ```
235
- docs/examples/mcp/
236
- ├── index.md # MCP overview
237
- ├── client_name.py # Python MCP client
238
- ├── client_name.js # Node.js MCP client
239
- └── client_name_usage.md # Documentation
240
- ```
241
-
242
- ## Pull Request Process
243
-
244
- ### Before Submitting
245
- 1. **Test Your Changes**
246
- ```bash
247
- rake test
248
- rake integration
249
- ```
250
-
251
- 2. **Check Code Quality**
252
- ```bash
253
- rubocop
254
- reek
255
- ```
256
- Note: `rubocop` and `reek` are not bundled dev dependencies. Install them manually if you wish to run these checks.
257
-
258
- 3. **Update Documentation**
259
- - Add/update relevant documentation
260
- - Include examples if applicable
261
- - Update CHANGELOG.md
262
-
263
- ### Submitting the Pull Request
264
-
265
- 1. **Create Descriptive Title**
266
- - Use the same format as commit messages
267
- - Be specific about what changed
268
-
269
- 2. **Write Comprehensive Description**
270
- ```markdown
271
- ## Summary
272
- Brief description of changes
273
-
274
- ## Changes Made
275
- - List key changes
276
- - Explain design decisions
277
- - Note any breaking changes
278
-
279
- ## Testing
280
- - Describe testing performed
281
- - Include test results if relevant
282
-
283
- ## Documentation
284
- - List documentation updates
285
- - Include screenshots if applicable
286
- ```
287
-
288
- 3. **Checklist**
289
- - [ ] Tests pass locally
290
- - [ ] Code follows style guidelines
291
- - [ ] Documentation updated
292
- - [ ] CHANGELOG.md updated (if user-facing)
293
- - [ ] No breaking changes (or documented)
294
-
295
- ### Review Process
296
- - Maintainers will review your pull request
297
- - Address feedback promptly and professionally
298
- - Be open to suggestions and improvements
299
- - Update your PR based on review comments
300
-
301
- ## Community Guidelines
302
-
303
- ### Communication
304
- - **Be Respectful**: Treat all community members with respect
305
- - **Be Constructive**: Provide helpful, actionable feedback
306
- - **Be Patient**: Maintainers and contributors are volunteers
307
- - **Be Collaborative**: Work together to improve the project
308
-
309
- ### Issue Reporting
310
- - **Search First**: Check if the issue already exists
311
- - **Be Specific**: Provide detailed reproduction steps
312
- - **Include Context**: OS, Ruby version, AIA version
313
- - **Provide Examples**: Include relevant code or configuration
314
-
315
- ### Feature Requests
316
- - **Describe Use Case**: Explain why the feature is needed
317
- - **Consider Alternatives**: Discuss other approaches
318
- - **Be Open to Discussion**: Feature scope may evolve
319
-
320
- ## Security
321
-
322
- ### Reporting Security Issues
323
- - **Do NOT** create public GitHub issues for security vulnerabilities
324
- - Email security issues to: [maintainer-email]
325
- - Include detailed description and reproduction steps
326
- - Allow reasonable time for response before public disclosure
327
-
328
- ### Security Best Practices
329
- - Never commit API keys or secrets
330
- - Validate all user inputs
331
- - Use secure defaults in configurations
332
- - Follow principle of least privilege
333
-
334
- ## Recognition
335
-
336
- ### Contributors
337
- All contributors are recognized in:
338
- - CONTRIBUTORS.md file
339
- - Release notes for significant contributions
340
- - GitHub contributor statistics
341
-
342
- ### Types of Recognition
343
- - **Code Contributors**: Code, tests, bug fixes
344
- - **Documentation Contributors**: Guides, examples, documentation
345
- - **Community Contributors**: Issue triage, user support
346
- - **Maintainers**: Ongoing project stewardship
347
-
348
- ## Getting Help
349
-
350
- ### Development Questions
351
- - **GitHub Discussions**: For general questions and ideas
352
- - **Issues**: For specific bugs or feature requests
353
- - **Documentation**: Check existing guides and examples
354
-
355
- ### Code Review
356
- - Ask for reviews in PR comments
357
- - Mention specific maintainers if needed
358
- - Be patient - reviews take time
359
-
360
- ### Community Support
361
- - Help other contributors
362
- - Share knowledge and experience
363
- - Mentor new contributors
364
-
365
- ## Release Process
366
-
367
- ### Version Management
368
- AIA follows semantic versioning (SemVer):
369
- - **MAJOR**: Breaking changes
370
- - **MINOR**: New features, backward compatible
371
- - **PATCH**: Bug fixes, backward compatible
372
-
373
- ### Release Schedule
374
- - No fixed schedule - releases when ready
375
- - Security fixes released promptly
376
- - Feature releases coordinated with maintainers
377
-
378
- ## Thank You!
379
-
380
- Thank you for considering contributing to AIA! Your contributions help make this tool better for everyone in the AI community.
381
-
382
- Questions? Feel free to open an issue or start a discussion on GitHub.
383
-
384
- ---
385
-
386
- *Last updated: February 2026*