ara-cli 0.1.10.5__py3-none-any.whl → 0.1.14.0__py3-none-any.whl

ara_cli/templates/prompt-modules/commands/empty.commands.md

@@ -1,14 +1,4 @@
 ### COMMANDS FOR ...
 Your job is now:
-* remember you are strictly following your given RULES AS EXPERT <role defined in rules file> for code and architectural code quality
-* ...
-   
-* return your results in the following format, ensuring your generated code blocks are not just code snippets but at complete method levels. Use for every single generated code block this format:
-```python
-# [ ] extract
-# filename: {path/filename}.py
-{python code}
-```
-* the extract and filename statements are only allowed once per code block
-
-* in case you think information is missing in order to generate a suffiently precise formulation, return a warning "WARNING: information is missing to correctly fullfill the job!" and then explain what kind of information you think is missing and how I could easily retrieve it.  
+* <main list for mandotory commands>
+* ...

ara_cli/templates/prompt-modules/commands/execute_scoped_todos_in_task.interview_agent.commands.md

@@ -0,0 +1 @@
+In the task file at {task_file_path}, there are multiple TODOs. Perform only the TODOs that relate to {todo_scope_description} (for example, Docker image builds, logging clean-up, or UI copy changes), implement the required changes, and then mark only those relevant TODOs as completed inside the task file.

ara_cli/templates/prompt-modules/commands/explain_single_file_purpose.interview_agent.commands.md

@@ -0,0 +1 @@
+What is this file about: {input_file_path}? Read the file using the appropriate tools and return a concise explanation of its purpose, structure, and key domain concepts.

ara_cli/templates/prompt-modules/commands/extract_file_information_bullets.interview_agent.commands.md

@@ -0,0 +1 @@
+Read the file at {input_file_path} and extract all key information into bullet points. Group the bullets by topic (for example: decisions, open questions, action items) and avoid repeating minor details.

ara_cli/templates/prompt-modules/commands/extract_general.commands.md

@@ -0,0 +1,12 @@
+# general file generation and file extract instructions
+* return only full copy pastable file content using this markdown codeblock format with 5 backticks:
+`````
+# [ ] extract
+# filename: <absolute filepath>/<filename>.<file_extension>
+{valid file content depending on the given file_extension}
+`````
+
+* The extract and filename statements are only allowed once per markdown code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/extract_markdown.commands.md

@@ -0,0 +1,11 @@
+# general markdown file generation and file extract instructions
+* return full copy pastable file content using a markdown code block with 5-backticks:
+`````
+# [ ] extract
+# filename: <filepath>/<filename>.md
+{markdown formatted text}
+`````
+* The extract and filename statements are only allowed once per markdown code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/extract_python.commands.md

@@ -0,0 +1,13 @@
+# general python code file generation and file extract instructions
+* return only full copy pastable file content using this markdown codeblock format:
+
+```python
+# [ ] extract
+# filename: src/{filename}.py
+{python code}
+
+```
+* The extract and filename statements are only allowed once per markdown code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/feature_add_or_modifiy_specified_behavior.commands.md

@@ -0,0 +1,36 @@
+# COMMANDS FOR ADDING OR MODIFYING EXISTING SPECIFIED BEHAVIOR
+
+**At first**: 
+
+Check if a set of feature files is given
+
+* In case no feature files are given:
+  * Stop immediately and respond with: "Error in prompt context: no feature files are given as already specified application behavior"
+
+* Else:
+  * Continue following the given instructions
+
+# Instructions
+Your job is now:
+* Silently analyze the given feature files and the specified behavior.
+* Silently analyze the additionally given information about new wanted behavior or changes of existing behavior
+* Develop adaptation strategies that minimize feature file changes with respect to any given already existing feature files, prefer reusing and adapting existing formulations/scenarios and steps over completely new formulations
+* Now formulate to fully cover the new or changed behavior (one, two or many changed or new feature files)
+
+Follow these feature file quality rules:
+* Each feature file should not consist of more than max 3 scenarios, each feature file should follow the single responsibility principle as well as the feature file formulations should follow the separation of concerns of feature files that fully cover the human user observable behavior described in the specification notes. Consider in your formulation of the Gherkin feature files that, when implementing the graphical user interfaces, the full functionality of the Python package Streamlit can be utilized.
+* Follow strictly the given feature file format in order to structure your feature files. 
+* You are allowed to use scenario outlines where useful. But in case they are not helpful in order to increase the readability you can just use standard scenario formulations.
+
+* Wrap and return the formulated feature files as full copy pastable file content in the following format as markdown code block:
+
+```artefact
+# [ ] extract 
+# filename: ara/features/{filename}.feature
+{formulation, with the valid feature file structure following the given feature files as reference}
+```
+
+* The extract and filename statements are only allowed once per markdown code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/feature_generate_initial_specified_bevahior.commands.md

@@ -0,0 +1,53 @@
+# COMMANDS FOR INITIALLY SPECIFYING APPLICATION BEHAVIOR USING FEATURE FILES
+
+* Given a description of the wanted application behavior as bullet point list, specification document, ...
+
+* And given this feature template with placeholders in <...>
+
+```
+@creator_Egermeier
+Feature: <descriptive title>
+
+  As a <user>
+  I want to <do something | need something>
+  So that <I can achieve something>
+
+  Contributes to <here comes your parent artefact> <here comes your classifier of the parent artefact>  
+
+  Description: <further optional description to understand
+  the rule, no format defined, the example artefact is only a placeholder>
+
+  Scenario: <descriptive scenario title>
+    Given <precondition>
+    When <action>
+    Then <expected result>
+
+  Scenario Outline: <descriptive scenario title>
+    Given <precondition>
+    When <action>
+    Then <expected result>
+
+    Examples:
+      | descriptive scenario title | precondition         | action             | expected result    |
+      | <example title 1>          | <example precond. 1> | <example action 1> | <example result 1> |
+      | <example title 2>          | <example precond. 2> | <example action 2> | <example result 2> |
+```
+
+# Instructions
+* Now formulate a set (one, two or many, each feature file should not consist of more than max 3 scenarios
+* Each feature file should follow the single responsibility principle as well as the feature file formulations should follow the separation of concerns) of feature files that fully cover the human user observable behavior described in the specification notes. 
+* Consider in your formulation of the Gherkin feature files when specifying the behavior of graphical user interfaces: Describe the behavior of the graphical user interfaces so that I can clearly imagine both how they work and their visual look and feel.
+* Follow strictly the given template format in order to structure your feature files. You are allowed to use scenario outlines where useful. But in case they are not helpful in order to increase the readability you can just use standard scenario formulations.
+
+* Wrap and return the formulated feature files as full copy pastable file content in the following format as markdown code block:
+
+```artefact
+# [ ] extract 
+# filename: ara/features/{filename}.feature 
+{formulation, with the valid feature file structure as given by the feature gherkin template}
+```
+
+* The extract and filename statements are only allowed once per markdown code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/fix_failing_behave_step_definitions.interview_agent.commands.md

@@ -0,0 +1 @@
+After the feature file {feature_file_path} was updated to reflect the changed functionality in {implementation_file_path}, the step definitions in {step_definitions_file_path} started failing. Run behave for this feature file, observe the failures, fix the step definitions, write the changes to disk, and repeat the cycle until all scenarios pass.

ara_cli/templates/prompt-modules/commands/fix_failing_pytest_tests.interview_agent.commands.md

@@ -0,0 +1 @@
+After the implementation file {implementation_file_path} was updated, the tests in {pytest_file_path} are failing. Run pytest for this test file, observe the results, fix the tests, write the changes to disk, and run pytest again. Continue the cycle until all tests pass.

ara_cli/templates/prompt-modules/commands/general_instruction_policy.commands.md

@@ -0,0 +1,47 @@
+You are to generate a response that may include Markdown, code blocks, or content that itself contains backticks.
+
+To ensure correct rendering follow this fencing policy:
+
+- Code files: wrap each file’s output in a triple-backtick fence labeled with the file extension (e.g., ```py, ```js, ```json).
+- Markdown or plain-text files: wrap each file’s output in a five-backtick fence labeled with md or txt (e.g., `````md or `````txt).
+- Do not use dynamic or variable-length fences. Only use:
+  - 3 backticks for code file types.
+  - 5 backticks for .md and .txt files.
+
+File block structure (mandatory, exact)
+- Each file must be returned in its own fenced block with this exact header format as the first two lines:
+  1) "# [x] extract"
+  2) "# filename: <absolute filepath>/<filename>.<extension>"
+- After these two lines, include the exact file content.
+- The first character of line 1 and line 2 inside the fence must be '#'.
+- The "# [x] extract" and "# filename:" headers must appear exactly once per fenced block.
+
+In case of nested code inside file contents
+- If the file content itself needs code blocks:
+  - Use standard triple backticks (```) inside the file content and for the outer fence five backticks (`````).
+  - For Markdown/Text files, this is safe because the outer fence is five backticks.
+  - For Code files, avoid embedding literal triple-backtick sequences inside the file content to prevent fence collisions. If unavoidable, ask the user to approve an .md/.txt wrapper instead.
+
+Template examples
+
+Code file (e.g., Python):
+```py
+# [x] extract
+# filename: /abs/path/app.py
+print("Hello")
+```
+
+Markdown file:
+`````md
+# [x] extract
+# filename: /abs/path/README.md
+# Project Title
+Some docs with a code block:
+
+```js
+console.log("hi");
+```
+`````
+
+
+

ara_cli/templates/prompt-modules/commands/generate_and_fix_pytest_tests.test_generation_agent.commands.md

@@ -0,0 +1 @@
+Generate pytest tests for the modules listed in {target_module_paths}, starting with {primary_module_name}. Aim for high coverage.

ara_cli/templates/prompt-modules/commands/prompt_template_tech_stack_transformer.commands.md

@@ -0,0 +1,95 @@
+# Tech Stack Prompt Template Transformer
+
+## PROMPT:
+You are a prompt template transformation specialist. Your task is to transform Python-specific prompt templates into equivalent templates for a different technology stack while maintaining the same structure, intent, and quality standards.
+
+### INPUT REQUIREMENTS:
+1. **Target Technology Stack** (MANDATORY): The technology stack to transform to (e.g., 'C#', 'Java', 'React', 'TypeScript', 'Go', 'Rust', etc.)
+2. **Source Prompt Templates** (MANDATORY): One or more Python prompt templates to transform
+
+### TRANSFORMATION RULES:
+1. **Preserve Structure and Intent**:
+   - Maintain the same logical flow and purpose of each prompt template
+   - Keep all sections and their hierarchical organization
+   - Preserve the extract/filename format for code generation
+
+2. **Technology-Specific Adaptations**:
+   - Replace Python-specific references with target technology equivalents
+   - Update file extensions (.py → appropriate extension for target stack)
+   - Adapt coding standards (PEP8 → target language conventions)
+   - Replace Python packages with target language equivalents
+   - Update testing frameworks (pytest/behave → target language testing tools)
+   - Adapt documentation styles (numpy docstrings → target language documentation)
+   - Update logging approaches to target language standards
+   - Adjust line/method/class length limits based on target language best practices. Prefer lower length limits.
+
+3. **Naming Convention**:
+   - Prefix each transformed template filename with the target technology
+   - Example: `python_bug_fixing_code.commands.md` → `csharp_bug_fixing_code.commands.md`
+
+4. **Output Format**:
+   - Return each transformed template as a complete, copy-pastable markdown file in 5-backticks
+   - The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+   - Use this format for each transformed template:
+
+`````markdown
+# [ ] extract
+# filename: ara/.araconfig/custom-prompt-modules/commands/{technology}_{original_template_name}
+{transformed template content}
+`````
+
+5. Markdown code block handling in prompt templates
+   The first and the second line of the Markdown code blocks used in the prompt templates serve as extraction control commands. the '#' tags in the first and second line of the code blocks must not be replaced by any other symbols, independent of the technology for which the markdown code block response is defined 
+
+6. **Technology Mapping Guidelines**:
+   **For C#/.NET:**
+   - PEP8 → C# Coding Conventions (Microsoft guidelines)
+   - pytest → NUnit/xUnit/MSTest
+   - behave → SpecFlow
+   - unittest.mock → Moq/NSubstitute
+   - numpy docstrings → XML documentation comments
+   - logging package → ILogger/Serilog/NLog
+
+   **For Java:**
+   - PEP8 → Java Code Conventions (Oracle/Google style)
+   - pytest → JUnit/TestNG
+   - behave → Cucumber-JVM
+   - unittest.mock → Mockito/EasyMock
+   - numpy docstrings → Javadoc
+   - logging package → SLF4J/Log4j
+
+   **For JavaScript/TypeScript:**
+   - PEP8 → ESLint/Prettier standards
+   - pytest → Jest/Mocha/Vitest
+   - behave → Cucumber.js, Selenium
+   - unittest.mock → Jest mocks/Sinon
+   - numpy docstrings → JSDoc/TSDoc
+   - logging package → Winston/Bunyan/Pino
+
+   **For React:**
+   - Include React-specific patterns (components, hooks, state management)
+   - pytest → Jest/React Testing Library
+   - behave → Selenium 
+   - Add component testing guidelines
+   - Include JSX/TSX specific rules
+
+7. **Preserve Key Constraints**:
+   - Maintain separation of concerns and single responsibility principles
+   - Keep modular/extensible design requirements
+   - Preserve testability requirements
+   - Maintain observability/logging requirements
+
+### VALIDATION:
+- Ensure all Python-specific references are properly transformed
+- Verify file paths and extensions match target technology conventions
+- Confirm testing and mocking frameworks are appropriate for target stack
+- Check that documentation styles match target language standards
+
+### OUTPUT SPECIFICATION:
+- Replace '# [ ] extract' with '# [x] extract' in all output blocks
+- Ensure each template is complete and ready for extraction
+- Include a summary of key transformations made for each template
+
+---
+
+**Begin transformation after receiving target technology stack and source templates.**

ara_cli/templates/prompt-modules/commands/python_bug_fixing_code.commands.md

@@ -0,0 +1,34 @@
+### COMMANDS FOR FIXING BUGS
+
+Your job is now to fix the described error:
+
+* Silently analyze the given error description or error log files
+* Silently review the provided source files and if given the provided feature file (specified behavior) to understand the current faulty implementation and draft silently a potential solution to fix the error
+* Develop implementation strategies that minimize code changes, prefer reusing existing methods over new implementations. Also always prefer to use existing python packages over your own implementation.
+
+When you touch code or need to generate code for bug fixing:
+* The max function or method length should not exceed 40 lines.
+* The max class length should not exceed 150 lines.
+* The max file length should not exceed 150 lines.
+* Split implementation files or functions/methods/classes in case they exceed their defined length maximum.
+* Apply as coding and design principle the separation of concerns and single responsibility principle in general and specifically when you need to split.
+
+* Important: you are NOT allowed to do any further refactorings not related to the bug fixing implementation. Refactoring for enhancing the code quality is not allowed.
+* The fixed code must fully implement the specified behavior in an easy testable and modular/extensible way.
+* Follow PEP8 coding guidelines.
+* Use descriptive numpy style docstrings for inline method and class documentation.
+* Use the python logger logging package to implement logging for all application modules that enables a fine granular full observability of the program flow by the log file. Use ./logs/<module_name>.log as filepath for logging.
+
+* Only return full copy pastable file content.
+* Use for every single generated code block this markdown code block format:
+
+```python
+# [ ] extract
+# filename: src/{filename}.py
+{python code}
+```
+
+* The extract and filename statements are only allowed once per code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/python_generate_code.commands.md

@@ -0,0 +1,27 @@
+### COMMANDS FOR IMPLEMENTING ONE OR A SET OF NEW OR CHANGED FEATURE FILES
+
+Your job is now:
+* Silently analyze the given feature files and the specified behavior.
+* Develop implementation strategies that minimize code changes with respect to any given code and test files, prefer reusing existing methods over new implementations.
+* The max function length should not exceed 25 lines. The max file length should not exceed 120 lines.
+* Always prefer to use existing python packages over your own implementation.
+* In case additional implementation instructions are given as:
+  * Specified in files with extensions "*.technology.md" follow strictly the specified mandatory python packages and tech stack
+  * Explicitly specified as example reference implementation: use this reference information as starting point for your own implementation
+* Fully implement the specified behavior in an easy testable and modular/extensible way, fully implement unit tests for your production code (try to achieve at least 90% code coverage) and implement for all given feature files the corresponding step definitions. Follow PEP8 coding guidelines, use numpy style docstrings for inline function documentation, apply as coding and design principle the separation of concerns and single responsibility principle.
+* Generated or reworked python methods must not exceed 25 lines of code. In case methods exceed this length they need to be split according to the single responsibility principle and separation of concerns.
+* Generated or reworked python files must not exceed 120 lines of code. In case files exceed this length they need to be split according to the single responsibility principle and separation of concerns.
+* Use the python logger logging package to implement logging for all application modules that enable a full observability of the program flow over the log file. Use ./logs/<module_name>.log as filepath for logging.
+
+* Only return full copy pastable file content for production code, unit test files and step definition files. Use for every single generated code block this markdown code block format:
+
+```python
+# [ ] extract
+# filename: src/{filename}.py
+{python code}
+```
+
+* The extract and filename statements are only allowed once per markdown code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/python_refactoring_code.commands.md

@@ -0,0 +1,39 @@
+### COMMANDS FOR REFACTORING
+
+Your job is now to refactor the code for enhancing the code quality and the design of the code according to the following guidelines:
+* Refactoring = Changing the internal structure of code
+* Without changing its external behavior
+* Goal = Improve readability, maintainability, and design
+-> "Refactoring is a change made to the internal structure of software to make it easier to understand and cheaper to modify without changing its observable behavior."
+-> "Refactoring changes how code is written, not what it does."
+
+Now do:
+* Silently analyze the given code base
+* Silently analyze the given feature file (specified behavior) to fully understand the flow and logic of the current implementation. Remember: you are not allowed to change specified behavior.
+
+When you refactor the code remember:
+* The max function or method length should not exceed 40 lines.
+* The max class length should not exceed 150 lines.
+* The max file length should not exceed 150 lines.
+* Split implementation files or functions/methods/classes in case they exceed their defined length maximum.
+* Apply as coding and design principle the separation of concerns and single responsibility principle in general and specifically when you need to split.
+* Flatten nested code structures (e.g. if/while/for statements) to only one nesting level.
+* The refactored code must fully implement the specified behavior in an easy testable and modular/extensible way.
+* Follow PEP8 coding guidelines.
+* Use descriptive numpy style docstrings for inline method and class documentation.
+* Use the python logger logging package to implement logging for all application modules that enables a fine granular full observability of the program flow by the log file. Use ./logs/<module_name>.log as filepath for logging.
+
+Your output specification is:
+* Only return full copy pastable file content.
+* Use for every single generated code block this markdown code block format:
+
+```python
+# [ ] extract
+# filename: src/{filename}.py
+{python code}
+```
+
+* The extract and filename statements are only allowed once per markdown code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/python_step_definitions_generation_and_fixing.commands.md

@@ -0,0 +1,40 @@
+### COMMANDS FOR CREATING AND CORRECTING STEP DEFINITIONS FOR FEATURE FILES
+
+**MANDATORY INPUT VALIDATION:**
+- Feature files (.feature) must be provided
+- Behave test report must be provided
+
+**PROMPT DEFINITION ERROR:** If mandatory input is missing, immediately stop and return: "ERROR: Missing mandatory input. Please provide both feature files (.feature) and behave test report before proceeding."
+
+**OPTIONAL INPUT:**
+- Already existing step definitions
+
+**PROMPT DEFINITION WARNING:** If optional input is missing: "WARNING: No existing step definitions provided. If step definitions already exist in your project, please include them as input context to avoid duplication and ensure consistency."
+
+### Your job is now:
+* Silently analyze the given feature files and behave test report to understand current test failures and missing step implementations.
+* Silently review any provided existing step definitions to avoid duplication and maintain consistency.
+* Develop step definition implementation strategies that minimize code changes with respect to existing step definitions, prefer reusing existing step patterns over new implementations.
+* The max function length should not exceed 25 lines. The max file length should not exceed 120 lines.
+* Always prefer to use existing python packages over your own implementation.
+* Use the behave testing framework for all step definition implementations.
+* Apply mocking extensively to isolate step definitions from external inputs and interfaces using unittest.mock or pytest-mock.
+* Fully implement all missing step definitions for the given feature files in an easy testable and modular/extensible way. Follow PEP8 coding guidelines, use numpy style docstrings for inline function documentation, apply as coding and design principle the separation of concerns and single responsibility principle.
+* Generated or reworked python methods must not exceed 25 lines of code. In case methods exceed this length they need to be split according to the single responsibility principle and separation of concerns.
+* Generated or reworked python files must not exceed 120 lines of code. In case files exceed this length they need to be split according to the single responsibility principle and separation of concerns.
+* Implement proper assertion methods that provide clear error messages when steps fail.
+* Use context.scenario, context.feature, and context.table appropriately for data sharing between steps.
+* Implement proper cleanup in @after_scenario and @after_feature hooks when necessary.
+
+* Only return full copy pastable file content for step definition files. Use for every single generated code block this markdown code block format:
+
+```python
+# [ ] extract
+# filename: ara/features/steps/{filename}_steps.py
+{python code}
+```
+
+* The extract and filename statements are only allowed once per markdown code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/python_unittest_generation_and_fixing.commands.md

@@ -0,0 +1,48 @@
+### COMMANDS FOR CREATING AND CORRECTING UNIT TESTS
+
+**MANDATORY INPUT VALIDATION:**
+- Feature files (.feature) must be provided
+- Code coverage report or pytest test report must be provided
+
+**PROMPT DEFINITION ERROR:** If mandatory input is missing, immediately stop and return: "ERROR: Missing mandatory input. Please provide both feature files (.feature) and code coverage/pytest test report before proceeding."
+
+**OPTIONAL INPUT:**
+- Already existing unit tests
+
+**PROMPT DEFINITION WARNING:** If optional input is missing: "WARNING: No existing unit tests provided. If unit tests already exist in your project, please include them as input context to avoid duplication and ensure consistency."
+
+#### Your job is now:
+* Silently analyze the given feature files and code coverage/pytest test report to understand current test gaps and implementation requirements.
+* Silently review any provided existing unit tests to avoid duplication and maintain consistency with existing test patterns.
+* Develop unit test implementation strategies that minimize code changes with respect to existing tests, prefer reusing existing test patterns and fixtures over new implementations.
+* The max function length should not exceed 25 lines. The max file length should not exceed 120 lines.
+* Always prefer to use existing python packages over your own implementation.
+* Use the pytest testing framework for all unit test implementations.
+* Apply mocking extensively to isolate unit tests from external inputs and interfaces using unittest.mock or pytest-mock. Mock all external dependencies, file I/O, network calls, and database interactions.
+* Fully implement comprehensive unit tests that achieve at least 90% code coverage for the specified behavior in an easy maintainable and modular/extensible way. Follow PEP8 coding guidelines, use numpy style docstrings for inline function documentation, apply as coding and design principle the separation of concerns and single responsibility principle.
+* Generated or reworked python methods must not exceed 25 lines of code. In case methods exceed this length they need to be split according to the single responsibility principle and separation of concerns.
+* Generated or reworked python files must not exceed 120 lines of code. In case files exceed this length they need to be split according to the single responsibility principle and separation of concerns.
+
+* Implement comprehensive test cases covering:
+  - Happy path scenarios
+  - Edge cases and boundary conditions
+  - Error handling and exception scenarios
+  - Input validation scenarios
+
+* Use pytest fixtures for test data setup and teardown to ensure test isolation.
+* Implement parametrized tests using @pytest.mark.parametrize for testing multiple input combinations efficiently.
+* Use descriptive test method names that clearly indicate what is being tested.
+* Include proper assertions with meaningful error messages.
+
+* Only return full copy pastable file content for unit test files. Use for every single generated code block this markdown code block format:
+
+```python
+# [ ] extract
+# filename: test/test_{filename}.py
+{python code}
+```
+
+* The extract and filename statements are only allowed once per markdown code block
+* The first character of the first line inside your code block must be '#' and the first character of the second line inside your code block must be '#'
+* replace the '# [ ] extract' statement of the template with '# [x] extract' in your response
+* in case of files get deprecated give me a list of files that can be safely deleted

ara_cli/templates/prompt-modules/commands/suggest_next_story_child_tasks.interview_agent.commands.md

@@ -0,0 +1 @@
+From the list of tasks attached to the user story at {user_story_task_file_path}, analyse all child tasks and propose the next {number_of_next_tasks} concrete tasks that should be created. For each new task, provide a short name, a one-sentence description, and the main files that will be affected.

ara_cli/templates/prompt-modules/commands/summarize_or_transcribe_media.interview_agent.commands.md

@@ -0,0 +1 @@
+Here is the path to the multimedia data: {media_file_path} / {attached_media_file_path}. Generate a concise summary of the transcript / return the full transcript of the audio or video.

ara_cli/templates/prompt-modules/commands/update_feature_to_match_implementation.feature_creation_agent.commands.md

@@ -0,0 +1 @@
+Update the feature file at {feature_file_path} so that it fully reflects the current behaviour of the implementation in {implementation_file_paths}. Keep the existing scenario structure where possible, adjust steps where necessary, and ensure that edge cases and negative paths are described explicitly.

ara_cli/templates/prompt-modules/commands/update_user_story_with_requirements.interview_agent.commands.md

@@ -0,0 +1 @@
+Reformulate and update the user story in {user_story_file_path} according to the new requirements {updated_requirements_description}. Reflect these requirements in clear acceptance criteria and, if needed, propose follow-up user stories.

ara_cli/version.py

@@ -1,2 +1,2 @@
 # version.py
-__version__ = "0.1.10.5"   # fith parameter like .0 for local install test purposes only. official numbers should be 4 digit numbers
+__version__ = "0.1.14.0"   # fith parameter like .0 for local install test purposes only. official numbers should be 4 digit numbers

{ara_cli-0.1.10.5.dist-info → ara_cli-0.1.14.0.dist-info}/METADATA

@@ -1,25 +1,34 @@
 Metadata-Version: 2.4
 Name: ara_cli
-Version: 0.1.10.5
+Version: 0.1.14.0
 Summary: Powerful, open source command-line tool for managing, structuring and automating software development artifacts in line with Business-Driven Development (BDD) and AI-assisted processes
 Description-Content-Type: text/markdown
+Requires-Dist: argcomplete
+Requires-Dist: argparse
+Requires-Dist: cmd2>=2.5
+Requires-Dist: rich
+Requires-Dist: typer
 Requires-Dist: langfuse
-Requires-Dist: litellm
+Requires-Dist: litellm>=1.81.0
 Requires-Dist: llama-index
 Requires-Dist: llama-index-llms-openai
 Requires-Dist: llama-index-retrievers-bm25
 Requires-Dist: openai
-Requires-Dist: markdown-it-py
-Requires-Dist: json-repair
-Requires-Dist: argparse
-Requires-Dist: argcomplete
-Requires-Dist: cmd2>=2.5
-Requires-Dist: charset-normalizer
-Requires-Dist: pydantic
 Requires-Dist: pydantic_ai
-Requires-Dist: python-docx
+Requires-Dist: charset-normalizer
+Requires-Dist: json-repair
+Requires-Dist: markdown-it-py
+Requires-Dist: openpyxl
+Requires-Dist: xlrd
+Requires-Dist: xlwt
+Requires-Dist: pandas
 Requires-Dist: pymupdf4llm
-Requires-Dist: typer
+Requires-Dist: python-docx
+Requires-Dist: python-pptx
+Requires-Dist: tabulate
+Requires-Dist: psutil
+Requires-Dist: pydantic
+Requires-Dist: requests
 Dynamic: description
 Dynamic: description-content-type
 Dynamic: requires-dist
@@ -130,6 +139,35 @@ ara autofix
 
 See `ara -h` for the complete list of commands and usage examples.
 
+---
+## Agent Commands
+
+`ara-cli` includes powerful agent-based capabilities that can be accessed through the interactive chat. These agents can perform complex, multi-step tasks, such as conducting interviews or automating coding workflows.
+
+To use the agent commands, first start an interactive chat session:
+
+```bash
+ara prompt chat <artefact_classifier> <artefact_name>
+```
+
+Once inside the chat, you can use the following commands to manage agents:
+
+| Command          | Shortcut | Description                                       |
+| ---------------- | -------- | ------------------------------------------------- |
+| `AGENT_RUN`      | `a`      | Run an agent by name.                             |
+| `AGENT_STOP`     | `as`     | Stop the currently running agent.                 |
+| `AGENT_CONTINUE` | `ac`     | Continue the agent's operation without new input. |
+| `AGENT_STATUS`   | `astat`  | Show the status of the current agent.             |
+| `exit`           |          | Exit from agent interfacto back to chat.          |
+
+**Example:**
+
+```bash
+ara> a interview_agent
+```
+
+**Important:** The agent functionality requires the `ara-agents` package to be installed separately. If you do not have `ara-agents` installed, please contact the Talsen Team for assistance.
+
 ---
 
 ## Artefact Structure