amd-gaia 0.15.0__py3-none-any.whl → 0.15.2__py3-none-any.whl

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 (185) hide show
  1. {amd_gaia-0.15.0.dist-info → amd_gaia-0.15.2.dist-info}/METADATA +222 -223
  2. amd_gaia-0.15.2.dist-info/RECORD +182 -0
  3. {amd_gaia-0.15.0.dist-info → amd_gaia-0.15.2.dist-info}/WHEEL +1 -1
  4. {amd_gaia-0.15.0.dist-info → amd_gaia-0.15.2.dist-info}/entry_points.txt +1 -0
  5. {amd_gaia-0.15.0.dist-info → amd_gaia-0.15.2.dist-info}/licenses/LICENSE.md +20 -20
  6. gaia/__init__.py +29 -29
  7. gaia/agents/__init__.py +19 -19
  8. gaia/agents/base/__init__.py +9 -9
  9. gaia/agents/base/agent.py +2132 -2177
  10. gaia/agents/base/api_agent.py +119 -120
  11. gaia/agents/base/console.py +1967 -1841
  12. gaia/agents/base/errors.py +237 -237
  13. gaia/agents/base/mcp_agent.py +86 -86
  14. gaia/agents/base/tools.py +88 -83
  15. gaia/agents/blender/__init__.py +7 -0
  16. gaia/agents/blender/agent.py +553 -556
  17. gaia/agents/blender/agent_simple.py +133 -135
  18. gaia/agents/blender/app.py +211 -211
  19. gaia/agents/blender/app_simple.py +41 -41
  20. gaia/agents/blender/core/__init__.py +16 -16
  21. gaia/agents/blender/core/materials.py +506 -506
  22. gaia/agents/blender/core/objects.py +316 -316
  23. gaia/agents/blender/core/rendering.py +225 -225
  24. gaia/agents/blender/core/scene.py +220 -220
  25. gaia/agents/blender/core/view.py +146 -146
  26. gaia/agents/chat/__init__.py +9 -9
  27. gaia/agents/chat/agent.py +809 -835
  28. gaia/agents/chat/app.py +1065 -1058
  29. gaia/agents/chat/session.py +508 -508
  30. gaia/agents/chat/tools/__init__.py +15 -15
  31. gaia/agents/chat/tools/file_tools.py +96 -96
  32. gaia/agents/chat/tools/rag_tools.py +1744 -1729
  33. gaia/agents/chat/tools/shell_tools.py +437 -436
  34. gaia/agents/code/__init__.py +7 -7
  35. gaia/agents/code/agent.py +549 -549
  36. gaia/agents/code/cli.py +377 -0
  37. gaia/agents/code/models.py +135 -135
  38. gaia/agents/code/orchestration/__init__.py +24 -24
  39. gaia/agents/code/orchestration/checklist_executor.py +1763 -1763
  40. gaia/agents/code/orchestration/checklist_generator.py +713 -713
  41. gaia/agents/code/orchestration/factories/__init__.py +9 -9
  42. gaia/agents/code/orchestration/factories/base.py +63 -63
  43. gaia/agents/code/orchestration/factories/nextjs_factory.py +118 -118
  44. gaia/agents/code/orchestration/factories/python_factory.py +106 -106
  45. gaia/agents/code/orchestration/orchestrator.py +841 -841
  46. gaia/agents/code/orchestration/project_analyzer.py +391 -391
  47. gaia/agents/code/orchestration/steps/__init__.py +67 -67
  48. gaia/agents/code/orchestration/steps/base.py +188 -188
  49. gaia/agents/code/orchestration/steps/error_handler.py +314 -314
  50. gaia/agents/code/orchestration/steps/nextjs.py +828 -828
  51. gaia/agents/code/orchestration/steps/python.py +307 -307
  52. gaia/agents/code/orchestration/template_catalog.py +469 -469
  53. gaia/agents/code/orchestration/workflows/__init__.py +14 -14
  54. gaia/agents/code/orchestration/workflows/base.py +80 -80
  55. gaia/agents/code/orchestration/workflows/nextjs.py +186 -186
  56. gaia/agents/code/orchestration/workflows/python.py +94 -94
  57. gaia/agents/code/prompts/__init__.py +11 -11
  58. gaia/agents/code/prompts/base_prompt.py +77 -77
  59. gaia/agents/code/prompts/code_patterns.py +2034 -2036
  60. gaia/agents/code/prompts/nextjs_prompt.py +40 -40
  61. gaia/agents/code/prompts/python_prompt.py +109 -109
  62. gaia/agents/code/schema_inference.py +365 -365
  63. gaia/agents/code/system_prompt.py +41 -41
  64. gaia/agents/code/tools/__init__.py +42 -42
  65. gaia/agents/code/tools/cli_tools.py +1138 -1138
  66. gaia/agents/code/tools/code_formatting.py +319 -319
  67. gaia/agents/code/tools/code_tools.py +769 -769
  68. gaia/agents/code/tools/error_fixing.py +1347 -1347
  69. gaia/agents/code/tools/external_tools.py +180 -180
  70. gaia/agents/code/tools/file_io.py +845 -845
  71. gaia/agents/code/tools/prisma_tools.py +190 -190
  72. gaia/agents/code/tools/project_management.py +1016 -1016
  73. gaia/agents/code/tools/testing.py +321 -321
  74. gaia/agents/code/tools/typescript_tools.py +122 -122
  75. gaia/agents/code/tools/validation_parsing.py +461 -461
  76. gaia/agents/code/tools/validation_tools.py +806 -806
  77. gaia/agents/code/tools/web_dev_tools.py +1758 -1758
  78. gaia/agents/code/validators/__init__.py +16 -16
  79. gaia/agents/code/validators/antipattern_checker.py +241 -241
  80. gaia/agents/code/validators/ast_analyzer.py +197 -197
  81. gaia/agents/code/validators/requirements_validator.py +145 -145
  82. gaia/agents/code/validators/syntax_validator.py +171 -171
  83. gaia/agents/docker/__init__.py +7 -7
  84. gaia/agents/docker/agent.py +643 -642
  85. gaia/agents/emr/__init__.py +8 -8
  86. gaia/agents/emr/agent.py +1504 -1506
  87. gaia/agents/emr/cli.py +1322 -1322
  88. gaia/agents/emr/constants.py +475 -475
  89. gaia/agents/emr/dashboard/__init__.py +4 -4
  90. gaia/agents/emr/dashboard/server.py +1972 -1974
  91. gaia/agents/jira/__init__.py +11 -11
  92. gaia/agents/jira/agent.py +894 -894
  93. gaia/agents/jira/jql_templates.py +299 -299
  94. gaia/agents/routing/__init__.py +7 -7
  95. gaia/agents/routing/agent.py +567 -570
  96. gaia/agents/routing/system_prompt.py +75 -75
  97. gaia/agents/summarize/__init__.py +11 -0
  98. gaia/agents/summarize/agent.py +885 -0
  99. gaia/agents/summarize/prompts.py +129 -0
  100. gaia/api/__init__.py +23 -23
  101. gaia/api/agent_registry.py +238 -238
  102. gaia/api/app.py +305 -305
  103. gaia/api/openai_server.py +575 -575
  104. gaia/api/schemas.py +186 -186
  105. gaia/api/sse_handler.py +373 -373
  106. gaia/apps/__init__.py +4 -4
  107. gaia/apps/llm/__init__.py +6 -6
  108. gaia/apps/llm/app.py +184 -169
  109. gaia/apps/summarize/app.py +116 -633
  110. gaia/apps/summarize/html_viewer.py +133 -133
  111. gaia/apps/summarize/pdf_formatter.py +284 -284
  112. gaia/audio/__init__.py +2 -2
  113. gaia/audio/audio_client.py +439 -439
  114. gaia/audio/audio_recorder.py +269 -269
  115. gaia/audio/kokoro_tts.py +599 -599
  116. gaia/audio/whisper_asr.py +432 -432
  117. gaia/chat/__init__.py +16 -16
  118. gaia/chat/app.py +428 -430
  119. gaia/chat/prompts.py +522 -522
  120. gaia/chat/sdk.py +1228 -1225
  121. gaia/cli.py +5659 -5632
  122. gaia/database/__init__.py +10 -10
  123. gaia/database/agent.py +176 -176
  124. gaia/database/mixin.py +290 -290
  125. gaia/database/testing.py +64 -64
  126. gaia/eval/batch_experiment.py +2332 -2332
  127. gaia/eval/claude.py +542 -542
  128. gaia/eval/config.py +37 -37
  129. gaia/eval/email_generator.py +512 -512
  130. gaia/eval/eval.py +3179 -3179
  131. gaia/eval/groundtruth.py +1130 -1130
  132. gaia/eval/transcript_generator.py +582 -582
  133. gaia/eval/webapp/README.md +167 -167
  134. gaia/eval/webapp/package-lock.json +875 -875
  135. gaia/eval/webapp/package.json +20 -20
  136. gaia/eval/webapp/public/app.js +3402 -3402
  137. gaia/eval/webapp/public/index.html +87 -87
  138. gaia/eval/webapp/public/styles.css +3661 -3661
  139. gaia/eval/webapp/server.js +415 -415
  140. gaia/eval/webapp/test-setup.js +72 -72
  141. gaia/installer/__init__.py +23 -0
  142. gaia/installer/init_command.py +1275 -0
  143. gaia/installer/lemonade_installer.py +619 -0
  144. gaia/llm/__init__.py +10 -2
  145. gaia/llm/base_client.py +60 -0
  146. gaia/llm/exceptions.py +12 -0
  147. gaia/llm/factory.py +70 -0
  148. gaia/llm/lemonade_client.py +3421 -3221
  149. gaia/llm/lemonade_manager.py +294 -294
  150. gaia/llm/providers/__init__.py +9 -0
  151. gaia/llm/providers/claude.py +108 -0
  152. gaia/llm/providers/lemonade.py +118 -0
  153. gaia/llm/providers/openai_provider.py +79 -0
  154. gaia/llm/vlm_client.py +382 -382
  155. gaia/logger.py +189 -189
  156. gaia/mcp/agent_mcp_server.py +245 -245
  157. gaia/mcp/blender_mcp_client.py +138 -138
  158. gaia/mcp/blender_mcp_server.py +648 -648
  159. gaia/mcp/context7_cache.py +332 -332
  160. gaia/mcp/external_services.py +518 -518
  161. gaia/mcp/mcp_bridge.py +811 -550
  162. gaia/mcp/servers/__init__.py +6 -6
  163. gaia/mcp/servers/docker_mcp.py +83 -83
  164. gaia/perf_analysis.py +361 -0
  165. gaia/rag/__init__.py +10 -10
  166. gaia/rag/app.py +293 -293
  167. gaia/rag/demo.py +304 -304
  168. gaia/rag/pdf_utils.py +235 -235
  169. gaia/rag/sdk.py +2194 -2194
  170. gaia/security.py +183 -163
  171. gaia/talk/app.py +287 -289
  172. gaia/talk/sdk.py +538 -538
  173. gaia/testing/__init__.py +87 -87
  174. gaia/testing/assertions.py +330 -330
  175. gaia/testing/fixtures.py +333 -333
  176. gaia/testing/mocks.py +493 -493
  177. gaia/util.py +46 -46
  178. gaia/utils/__init__.py +33 -33
  179. gaia/utils/file_watcher.py +675 -675
  180. gaia/utils/parsing.py +223 -223
  181. gaia/version.py +100 -100
  182. amd_gaia-0.15.0.dist-info/RECORD +0 -168
  183. gaia/agents/code/app.py +0 -266
  184. gaia/llm/llm_client.py +0 -723
  185. {amd_gaia-0.15.0.dist-info → amd_gaia-0.15.2.dist-info}/top_level.txt +0 -0
@@ -1,40 +1,40 @@
1
- # Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
2
- # SPDX-License-Identifier: MIT
3
- """Next.js CRUD app builder prompt for Code Agent."""
4
-
5
- # Package version matrix for Next.js 14 compatibility
6
- NEXTJS_VERSION = "14.2.33"
7
- PRISMA_VERSION = "5.22.0"
8
- ZOD_VERSION = "3.23.8"
9
-
10
- NEXTJS_PROMPT = """=== NEXT.JS DEVELOPMENT ===
11
-
12
- ## Role
13
- You are a Next.js full-stack developer creating CRUD applications.
14
-
15
- ## Output Format
16
- Respond with JSON: {"thought": "...", "tool": "...", "tool_args": {...}}
17
-
18
- ## Quality Standards
19
- - Components must have loading states and error boundaries
20
- - Forms must validate input before submission
21
- - Empty states must show helpful guidance
22
- - All CRUD operations must be tested
23
-
24
- ## Technical Rules
25
- - Server components: `import { prisma } from '@/lib/prisma'`
26
- - Client components: `import type { ModelName } from '@prisma/client'`
27
- - NEVER import prisma client directly in client components
28
- - Run `prisma generate` after schema changes
29
-
30
- ## Field Consistency
31
- Use the SAME fields dict across all tools:
32
- - manage_data_model(fields=...) → Prisma schema
33
- - manage_api_endpoint(fields=...) → Zod validation
34
- - manage_react_component(fields=...) → Form fields
35
-
36
- ## Conventions
37
- - Models: Singular PascalCase (Todo, Post)
38
- - Fields: camelCase (firstName, createdAt)
39
- - Routes: Plural kebab-case (/api/todos)
40
- """
1
+ # Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
2
+ # SPDX-License-Identifier: MIT
3
+ """Next.js CRUD app builder prompt for Code Agent."""
4
+
5
+ # Package version matrix for Next.js 14 compatibility
6
+ NEXTJS_VERSION = "14.2.33"
7
+ PRISMA_VERSION = "5.22.0"
8
+ ZOD_VERSION = "3.23.8"
9
+
10
+ NEXTJS_PROMPT = """=== NEXT.JS DEVELOPMENT ===
11
+
12
+ ## Role
13
+ You are a Next.js full-stack developer creating CRUD applications.
14
+
15
+ ## Output Format
16
+ Respond with JSON: {"thought": "...", "tool": "...", "tool_args": {...}}
17
+
18
+ ## Quality Standards
19
+ - Components must have loading states and error boundaries
20
+ - Forms must validate input before submission
21
+ - Empty states must show helpful guidance
22
+ - All CRUD operations must be tested
23
+
24
+ ## Technical Rules
25
+ - Server components: `import { prisma } from '@/lib/prisma'`
26
+ - Client components: `import type { ModelName } from '@prisma/client'`
27
+ - NEVER import prisma client directly in client components
28
+ - Run `prisma generate` after schema changes
29
+
30
+ ## Field Consistency
31
+ Use the SAME fields dict across all tools:
32
+ - manage_data_model(fields=...) → Prisma schema
33
+ - manage_api_endpoint(fields=...) → Zod validation
34
+ - manage_react_component(fields=...) → Form fields
35
+
36
+ ## Conventions
37
+ - Models: Singular PascalCase (Todo, Post)
38
+ - Fields: camelCase (firstName, createdAt)
39
+ - Routes: Plural kebab-case (/api/todos)
40
+ """
@@ -1,109 +1,109 @@
1
- # Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
2
- # SPDX-License-Identifier: MIT
3
- """Python-specific prompt module for Code Agent."""
4
-
5
- from typing import Optional
6
-
7
- from .base_prompt import get_base_prompt
8
-
9
-
10
- def get_python_prompt(gaia_md_path: Optional[str] = None) -> str:
11
- """Get complete Python development prompt (base + Python-specific).
12
-
13
- Args:
14
- gaia_md_path: Optional path to GAIA.md file for project context
15
-
16
- Returns:
17
- Complete prompt with base universal guidance + Python-specific workflow
18
- """
19
- base = get_base_prompt(gaia_md_path)
20
-
21
- python_specific = """
22
- ========== PYTHON DEVELOPMENT WORKFLOW ==========
23
-
24
- FOR PYTHON PROJECT CREATION REQUESTS:
25
- When the user asks to create a complete Python project/application, your plan should be:
26
- "plan": [
27
- {"tool": "create_project", "tool_args": {"query": "user's complete project description"}}
28
- ]
29
-
30
- The create_project tool will:
31
- 1. Design the project structure
32
- 2. Generate ALL necessary files
33
- 3. Return the actual project name and files created
34
-
35
- After create_project completes successfully, you MUST create a NEW plan to validate and test:
36
- 1. Examine the tool result to see the actual project_name (e.g., "calculator_app")
37
- 2. Use list_files to discover the actual project structure
38
- 3. Create a NEW plan with these steps (using the ACTUAL project name):
39
- - list_files(project_name) - See what was created
40
- - validate_project(project_name, fix=true) - Check project structure and fix issues
41
- - auto_fix_syntax_errors(project_name) - Fix any syntax issues
42
- - analyze_with_pylint(project_name) - Check code quality
43
- - fix_code(project_name/file.py) - Fix any errors found by pylint (if needed)
44
-
45
- 4. Run TESTS to validate (DO NOT run main.py as it may wait for input and timeout):
46
- - Use run_tests tool to run pytest on the entire test suite
47
- - Check the "tests_passed" field in the result - if FALSE, tests have FAILED
48
- - If "tests_passed": false OR "return_code": 1, examine the errors and fix them
49
- - Re-run tests until "tests_passed": true
50
-
51
- CRITICAL: DO NOT execute main.py - it may be a web server or interactive app that hangs!
52
- CRITICAL: Use run_tests tool to validate ALL tests at once with pytest!
53
- CRITICAL: Check "tests_passed" field - if false, tests FAILED (do NOT claim success)!
54
- CRITICAL: Task is complete ONLY when: pylint passes AND "tests_passed": true!
55
-
56
- Example validation plan:
57
- {"plan": [
58
- {"tool": "list_files", "tool_args": {"path": "todo_app"}},
59
- {"tool": "validate_project", "tool_args": {"project_path": "todo_app", "fix": true}},
60
- {"tool": "auto_fix_syntax_errors", "tool_args": {"project_path": "todo_app"}},
61
- {"tool": "analyze_with_pylint", "tool_args": {"file_path": "todo_app"}},
62
- {"tool": "run_tests", "tool_args": {"project_path": "todo_app"}}
63
- ]}
64
-
65
- If run_tests fails, create a NEW plan to fix the errors and re-run tests!
66
-
67
- IMPORTANT: When creating any Python project, ALWAYS include:
68
- 1. README.md - With project overview, features, installation, and usage instructions
69
- 2. requirements.txt - List all required packages with versions
70
-
71
- PYTHON TOOL USAGE:
72
- For project creation: Use create_project to generate files, then CONTINUE with validation.
73
- For code generation: Use generate_function, generate_class, or generate_test.
74
- For file operations: Use read_file, write_python_file, edit_python_file.
75
- For error fixing: Use auto_fix_syntax_errors to scan projects, or fix_code for individual files.
76
-
77
- CRITICAL: After creating any Python project or code:
78
- 1. Run validate_project to check structure and fix common issues
79
- 2. Run auto_fix_syntax_errors to fix any truncated or broken files
80
- 3. Run analyze_with_pylint on the ENTIRE PROJECT FOLDER to get all errors at once
81
- 4. Use fix_code on each file that has errors (based on pylint results)
82
- 5. Run execute_python_file on main.py to test the application
83
- 6. Run execute_python_file on test files to verify tests pass
84
- 7. If execution fails (has_errors: true), read the stderr output and fix the errors
85
-
86
- PYLINT STRATEGY: Always run pylint on the project directory, not individual files.
87
-
88
- MANDATORY TEST REQUIREMENTS:
89
- - ALWAYS create test_*.py files for all main modules
90
- - Use generate_test tool to create comprehensive unit tests
91
- - Test all major functions and classes
92
- - Include edge cases and error handling tests
93
-
94
- PYTHON-SPECIFIC ERROR PATTERNS:
95
- - "is_valid": false in read_python_file → Fix the syntax error shown in "errors"
96
- - "has_errors": true in execute_python_file → Fix the error shown in "stderr"
97
- - Issues in analyze_with_pylint → Use fix_linting_errors or edit_python_file
98
- - "status": "error" in any tool result → READ the error message and fix the issue:
99
- * If pylint has invalid arguments, retry with valid values (e.g., confidence=HIGH)
100
- * If a command fails, check stderr and adjust parameters
101
- * ALWAYS recover from tool errors - don't ignore them!
102
-
103
- PYTHON MANDATORY WORKFLOW: Create → Check Syntax → Fix → Write Tests → Lint → Test → Verify.
104
- DO NOT STOP after create_project! Continue with ALL validation steps until verified working.
105
-
106
- ========== END PYTHON DEVELOPMENT WORKFLOW ==========
107
- """
108
-
109
- return base + python_specific
1
+ # Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
2
+ # SPDX-License-Identifier: MIT
3
+ """Python-specific prompt module for Code Agent."""
4
+
5
+ from typing import Optional
6
+
7
+ from .base_prompt import get_base_prompt
8
+
9
+
10
+ def get_python_prompt(gaia_md_path: Optional[str] = None) -> str:
11
+ """Get complete Python development prompt (base + Python-specific).
12
+
13
+ Args:
14
+ gaia_md_path: Optional path to GAIA.md file for project context
15
+
16
+ Returns:
17
+ Complete prompt with base universal guidance + Python-specific workflow
18
+ """
19
+ base = get_base_prompt(gaia_md_path)
20
+
21
+ python_specific = """
22
+ ========== PYTHON DEVELOPMENT WORKFLOW ==========
23
+
24
+ FOR PYTHON PROJECT CREATION REQUESTS:
25
+ When the user asks to create a complete Python project/application, your plan should be:
26
+ "plan": [
27
+ {"tool": "create_project", "tool_args": {"query": "user's complete project description"}}
28
+ ]
29
+
30
+ The create_project tool will:
31
+ 1. Design the project structure
32
+ 2. Generate ALL necessary files
33
+ 3. Return the actual project name and files created
34
+
35
+ After create_project completes successfully, you MUST create a NEW plan to validate and test:
36
+ 1. Examine the tool result to see the actual project_name (e.g., "calculator_app")
37
+ 2. Use list_files to discover the actual project structure
38
+ 3. Create a NEW plan with these steps (using the ACTUAL project name):
39
+ - list_files(project_name) - See what was created
40
+ - validate_project(project_name, fix=true) - Check project structure and fix issues
41
+ - auto_fix_syntax_errors(project_name) - Fix any syntax issues
42
+ - analyze_with_pylint(project_name) - Check code quality
43
+ - fix_code(project_name/file.py) - Fix any errors found by pylint (if needed)
44
+
45
+ 4. Run TESTS to validate (DO NOT run main.py as it may wait for input and timeout):
46
+ - Use run_tests tool to run pytest on the entire test suite
47
+ - Check the "tests_passed" field in the result - if FALSE, tests have FAILED
48
+ - If "tests_passed": false OR "return_code": 1, examine the errors and fix them
49
+ - Re-run tests until "tests_passed": true
50
+
51
+ CRITICAL: DO NOT execute main.py - it may be a web server or interactive app that hangs!
52
+ CRITICAL: Use run_tests tool to validate ALL tests at once with pytest!
53
+ CRITICAL: Check "tests_passed" field - if false, tests FAILED (do NOT claim success)!
54
+ CRITICAL: Task is complete ONLY when: pylint passes AND "tests_passed": true!
55
+
56
+ Example validation plan:
57
+ {"plan": [
58
+ {"tool": "list_files", "tool_args": {"path": "todo_app"}},
59
+ {"tool": "validate_project", "tool_args": {"project_path": "todo_app", "fix": true}},
60
+ {"tool": "auto_fix_syntax_errors", "tool_args": {"project_path": "todo_app"}},
61
+ {"tool": "analyze_with_pylint", "tool_args": {"file_path": "todo_app"}},
62
+ {"tool": "run_tests", "tool_args": {"project_path": "todo_app"}}
63
+ ]}
64
+
65
+ If run_tests fails, create a NEW plan to fix the errors and re-run tests!
66
+
67
+ IMPORTANT: When creating any Python project, ALWAYS include:
68
+ 1. README.md - With project overview, features, installation, and usage instructions
69
+ 2. requirements.txt - List all required packages with versions
70
+
71
+ PYTHON TOOL USAGE:
72
+ For project creation: Use create_project to generate files, then CONTINUE with validation.
73
+ For code generation: Use generate_function, generate_class, or generate_test.
74
+ For file operations: Use read_file, write_python_file, edit_python_file.
75
+ For error fixing: Use auto_fix_syntax_errors to scan projects, or fix_code for individual files.
76
+
77
+ CRITICAL: After creating any Python project or code:
78
+ 1. Run validate_project to check structure and fix common issues
79
+ 2. Run auto_fix_syntax_errors to fix any truncated or broken files
80
+ 3. Run analyze_with_pylint on the ENTIRE PROJECT FOLDER to get all errors at once
81
+ 4. Use fix_code on each file that has errors (based on pylint results)
82
+ 5. Run execute_python_file on main.py to test the application
83
+ 6. Run execute_python_file on test files to verify tests pass
84
+ 7. If execution fails (has_errors: true), read the stderr output and fix the errors
85
+
86
+ PYLINT STRATEGY: Always run pylint on the project directory, not individual files.
87
+
88
+ MANDATORY TEST REQUIREMENTS:
89
+ - ALWAYS create test_*.py files for all main modules
90
+ - Use generate_test tool to create comprehensive unit tests
91
+ - Test all major functions and classes
92
+ - Include edge cases and error handling tests
93
+
94
+ PYTHON-SPECIFIC ERROR PATTERNS:
95
+ - "is_valid": false in read_python_file → Fix the syntax error shown in "errors"
96
+ - "has_errors": true in execute_python_file → Fix the error shown in "stderr"
97
+ - Issues in analyze_with_pylint → Use fix_linting_errors or edit_python_file
98
+ - "status": "error" in any tool result → READ the error message and fix the issue:
99
+ * If pylint has invalid arguments, retry with valid values (e.g., confidence=HIGH)
100
+ * If a command fails, check stderr and adjust parameters
101
+ * ALWAYS recover from tool errors - don't ignore them!
102
+
103
+ PYTHON MANDATORY WORKFLOW: Create → Check Syntax → Fix → Write Tests → Lint → Test → Verify.
104
+ DO NOT STOP after create_project! Continue with ALL validation steps until verified working.
105
+
106
+ ========== END PYTHON DEVELOPMENT WORKFLOW ==========
107
+ """
108
+
109
+ return base + python_specific