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.
- {amd_gaia-0.15.0.dist-info → amd_gaia-0.15.2.dist-info}/METADATA +222 -223
- amd_gaia-0.15.2.dist-info/RECORD +182 -0
- {amd_gaia-0.15.0.dist-info → amd_gaia-0.15.2.dist-info}/WHEEL +1 -1
- {amd_gaia-0.15.0.dist-info → amd_gaia-0.15.2.dist-info}/entry_points.txt +1 -0
- {amd_gaia-0.15.0.dist-info → amd_gaia-0.15.2.dist-info}/licenses/LICENSE.md +20 -20
- gaia/__init__.py +29 -29
- gaia/agents/__init__.py +19 -19
- gaia/agents/base/__init__.py +9 -9
- gaia/agents/base/agent.py +2132 -2177
- gaia/agents/base/api_agent.py +119 -120
- gaia/agents/base/console.py +1967 -1841
- gaia/agents/base/errors.py +237 -237
- gaia/agents/base/mcp_agent.py +86 -86
- gaia/agents/base/tools.py +88 -83
- gaia/agents/blender/__init__.py +7 -0
- gaia/agents/blender/agent.py +553 -556
- gaia/agents/blender/agent_simple.py +133 -135
- gaia/agents/blender/app.py +211 -211
- gaia/agents/blender/app_simple.py +41 -41
- gaia/agents/blender/core/__init__.py +16 -16
- gaia/agents/blender/core/materials.py +506 -506
- gaia/agents/blender/core/objects.py +316 -316
- gaia/agents/blender/core/rendering.py +225 -225
- gaia/agents/blender/core/scene.py +220 -220
- gaia/agents/blender/core/view.py +146 -146
- gaia/agents/chat/__init__.py +9 -9
- gaia/agents/chat/agent.py +809 -835
- gaia/agents/chat/app.py +1065 -1058
- gaia/agents/chat/session.py +508 -508
- gaia/agents/chat/tools/__init__.py +15 -15
- gaia/agents/chat/tools/file_tools.py +96 -96
- gaia/agents/chat/tools/rag_tools.py +1744 -1729
- gaia/agents/chat/tools/shell_tools.py +437 -436
- gaia/agents/code/__init__.py +7 -7
- gaia/agents/code/agent.py +549 -549
- gaia/agents/code/cli.py +377 -0
- gaia/agents/code/models.py +135 -135
- gaia/agents/code/orchestration/__init__.py +24 -24
- gaia/agents/code/orchestration/checklist_executor.py +1763 -1763
- gaia/agents/code/orchestration/checklist_generator.py +713 -713
- gaia/agents/code/orchestration/factories/__init__.py +9 -9
- gaia/agents/code/orchestration/factories/base.py +63 -63
- gaia/agents/code/orchestration/factories/nextjs_factory.py +118 -118
- gaia/agents/code/orchestration/factories/python_factory.py +106 -106
- gaia/agents/code/orchestration/orchestrator.py +841 -841
- gaia/agents/code/orchestration/project_analyzer.py +391 -391
- gaia/agents/code/orchestration/steps/__init__.py +67 -67
- gaia/agents/code/orchestration/steps/base.py +188 -188
- gaia/agents/code/orchestration/steps/error_handler.py +314 -314
- gaia/agents/code/orchestration/steps/nextjs.py +828 -828
- gaia/agents/code/orchestration/steps/python.py +307 -307
- gaia/agents/code/orchestration/template_catalog.py +469 -469
- gaia/agents/code/orchestration/workflows/__init__.py +14 -14
- gaia/agents/code/orchestration/workflows/base.py +80 -80
- gaia/agents/code/orchestration/workflows/nextjs.py +186 -186
- gaia/agents/code/orchestration/workflows/python.py +94 -94
- gaia/agents/code/prompts/__init__.py +11 -11
- gaia/agents/code/prompts/base_prompt.py +77 -77
- gaia/agents/code/prompts/code_patterns.py +2034 -2036
- gaia/agents/code/prompts/nextjs_prompt.py +40 -40
- gaia/agents/code/prompts/python_prompt.py +109 -109
- gaia/agents/code/schema_inference.py +365 -365
- gaia/agents/code/system_prompt.py +41 -41
- gaia/agents/code/tools/__init__.py +42 -42
- gaia/agents/code/tools/cli_tools.py +1138 -1138
- gaia/agents/code/tools/code_formatting.py +319 -319
- gaia/agents/code/tools/code_tools.py +769 -769
- gaia/agents/code/tools/error_fixing.py +1347 -1347
- gaia/agents/code/tools/external_tools.py +180 -180
- gaia/agents/code/tools/file_io.py +845 -845
- gaia/agents/code/tools/prisma_tools.py +190 -190
- gaia/agents/code/tools/project_management.py +1016 -1016
- gaia/agents/code/tools/testing.py +321 -321
- gaia/agents/code/tools/typescript_tools.py +122 -122
- gaia/agents/code/tools/validation_parsing.py +461 -461
- gaia/agents/code/tools/validation_tools.py +806 -806
- gaia/agents/code/tools/web_dev_tools.py +1758 -1758
- gaia/agents/code/validators/__init__.py +16 -16
- gaia/agents/code/validators/antipattern_checker.py +241 -241
- gaia/agents/code/validators/ast_analyzer.py +197 -197
- gaia/agents/code/validators/requirements_validator.py +145 -145
- gaia/agents/code/validators/syntax_validator.py +171 -171
- gaia/agents/docker/__init__.py +7 -7
- gaia/agents/docker/agent.py +643 -642
- gaia/agents/emr/__init__.py +8 -8
- gaia/agents/emr/agent.py +1504 -1506
- gaia/agents/emr/cli.py +1322 -1322
- gaia/agents/emr/constants.py +475 -475
- gaia/agents/emr/dashboard/__init__.py +4 -4
- gaia/agents/emr/dashboard/server.py +1972 -1974
- gaia/agents/jira/__init__.py +11 -11
- gaia/agents/jira/agent.py +894 -894
- gaia/agents/jira/jql_templates.py +299 -299
- gaia/agents/routing/__init__.py +7 -7
- gaia/agents/routing/agent.py +567 -570
- gaia/agents/routing/system_prompt.py +75 -75
- gaia/agents/summarize/__init__.py +11 -0
- gaia/agents/summarize/agent.py +885 -0
- gaia/agents/summarize/prompts.py +129 -0
- gaia/api/__init__.py +23 -23
- gaia/api/agent_registry.py +238 -238
- gaia/api/app.py +305 -305
- gaia/api/openai_server.py +575 -575
- gaia/api/schemas.py +186 -186
- gaia/api/sse_handler.py +373 -373
- gaia/apps/__init__.py +4 -4
- gaia/apps/llm/__init__.py +6 -6
- gaia/apps/llm/app.py +184 -169
- gaia/apps/summarize/app.py +116 -633
- gaia/apps/summarize/html_viewer.py +133 -133
- gaia/apps/summarize/pdf_formatter.py +284 -284
- gaia/audio/__init__.py +2 -2
- gaia/audio/audio_client.py +439 -439
- gaia/audio/audio_recorder.py +269 -269
- gaia/audio/kokoro_tts.py +599 -599
- gaia/audio/whisper_asr.py +432 -432
- gaia/chat/__init__.py +16 -16
- gaia/chat/app.py +428 -430
- gaia/chat/prompts.py +522 -522
- gaia/chat/sdk.py +1228 -1225
- gaia/cli.py +5659 -5632
- gaia/database/__init__.py +10 -10
- gaia/database/agent.py +176 -176
- gaia/database/mixin.py +290 -290
- gaia/database/testing.py +64 -64
- gaia/eval/batch_experiment.py +2332 -2332
- gaia/eval/claude.py +542 -542
- gaia/eval/config.py +37 -37
- gaia/eval/email_generator.py +512 -512
- gaia/eval/eval.py +3179 -3179
- gaia/eval/groundtruth.py +1130 -1130
- gaia/eval/transcript_generator.py +582 -582
- gaia/eval/webapp/README.md +167 -167
- gaia/eval/webapp/package-lock.json +875 -875
- gaia/eval/webapp/package.json +20 -20
- gaia/eval/webapp/public/app.js +3402 -3402
- gaia/eval/webapp/public/index.html +87 -87
- gaia/eval/webapp/public/styles.css +3661 -3661
- gaia/eval/webapp/server.js +415 -415
- gaia/eval/webapp/test-setup.js +72 -72
- gaia/installer/__init__.py +23 -0
- gaia/installer/init_command.py +1275 -0
- gaia/installer/lemonade_installer.py +619 -0
- gaia/llm/__init__.py +10 -2
- gaia/llm/base_client.py +60 -0
- gaia/llm/exceptions.py +12 -0
- gaia/llm/factory.py +70 -0
- gaia/llm/lemonade_client.py +3421 -3221
- gaia/llm/lemonade_manager.py +294 -294
- gaia/llm/providers/__init__.py +9 -0
- gaia/llm/providers/claude.py +108 -0
- gaia/llm/providers/lemonade.py +118 -0
- gaia/llm/providers/openai_provider.py +79 -0
- gaia/llm/vlm_client.py +382 -382
- gaia/logger.py +189 -189
- gaia/mcp/agent_mcp_server.py +245 -245
- gaia/mcp/blender_mcp_client.py +138 -138
- gaia/mcp/blender_mcp_server.py +648 -648
- gaia/mcp/context7_cache.py +332 -332
- gaia/mcp/external_services.py +518 -518
- gaia/mcp/mcp_bridge.py +811 -550
- gaia/mcp/servers/__init__.py +6 -6
- gaia/mcp/servers/docker_mcp.py +83 -83
- gaia/perf_analysis.py +361 -0
- gaia/rag/__init__.py +10 -10
- gaia/rag/app.py +293 -293
- gaia/rag/demo.py +304 -304
- gaia/rag/pdf_utils.py +235 -235
- gaia/rag/sdk.py +2194 -2194
- gaia/security.py +183 -163
- gaia/talk/app.py +287 -289
- gaia/talk/sdk.py +538 -538
- gaia/testing/__init__.py +87 -87
- gaia/testing/assertions.py +330 -330
- gaia/testing/fixtures.py +333 -333
- gaia/testing/mocks.py +493 -493
- gaia/util.py +46 -46
- gaia/utils/__init__.py +33 -33
- gaia/utils/file_watcher.py +675 -675
- gaia/utils/parsing.py +223 -223
- gaia/version.py +100 -100
- amd_gaia-0.15.0.dist-info/RECORD +0 -168
- gaia/agents/code/app.py +0 -266
- gaia/llm/llm_client.py +0 -723
- {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
|