ara-cli 0.1.10.7__tar.gz → 0.1.11.3__tar.gz

{ara_cli-0.1.10.7 → ara_cli-0.1.11.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ara_cli
-Version: 0.1.10.7
+Version: 0.1.11.3
 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: langfuse

{ara_cli-0.1.10.7 → ara_cli-0.1.11.3}/ara_cli/__main__.py

@@ -13,6 +13,7 @@ from ara_cli.ara_subcommands.prompt import register as register_prompt_cli
 from ara_cli.ara_subcommands.chat import register as register_chat_cli
 from ara_cli.ara_subcommands.template import register as register_template_cli
 from ara_cli.ara_subcommands.fetch_templates import register as register_fetch_templates_cli
+from ara_cli.ara_subcommands.fetch_scripts import register as register_fetch_scripts_cli
 from ara_cli.ara_subcommands.read import register as register_read_cli
 from ara_cli.ara_subcommands.reconnect import register as register_reconnect_cli
 from ara_cli.ara_subcommands.read_status import register as register_read_status_cli
@@ -212,7 +213,7 @@ ara chat examples:
         commands_requiring_ara = {
             'create', 'delete', 'rename', 'list', 'list-tags', 'prompt',
             'read', 'reconnect', 'read-status', 'read-user', 'set-status',
-            'set-user', 'classifier-directory', 'scan', 'autofix'
+            'set-user', 'scan', 'autofix'
         }
 
         if ctx.invoked_subcommand in commands_requiring_ara:
@@ -228,6 +229,7 @@ ara chat examples:
     register_chat_cli(app)
     register_template_cli(app)
     register_fetch_templates_cli(app)
+    register_fetch_scripts_cli(app)
     register_read_cli(app)
     register_reconnect_cli(app)
     register_read_status_cli(app)

{ara_cli-0.1.10.7 → ara_cli-0.1.11.3}/ara_cli/ara_config.py

@@ -29,6 +29,8 @@ class ARAconfig(BaseModel):
     doc_dir: str = "./docs"
     local_prompt_templates_dir: str = "./ara/.araconfig"
     custom_prompt_templates_subdir: Optional[str] = "custom-prompt-modules"
+    local_scripts_dir: str = "./ara/.araconfig"
+    custom_scripts_subdir: Optional[str] = "custom-scripts"
     local_ara_templates_dir: str = "./ara/.araconfig/templates/"
     ara_prompt_given_list_includes: List[str] = Field(
         default_factory=lambda: [
@@ -113,6 +115,7 @@ class ARAconfig(BaseModel):
             "ext_code_dirs": [{"source_dir": "./src"}, {"source_dir": "./tests"}],
             "local_ara_templates_dir": "./ara/.araconfig/templates/",
             "local_prompt_templates_dir": "./ara/.araconfig",
+            "local_scripts_dir": "./ara/.araconfig",
             "glossary_dir": "./glossary",
         }
 

ara_cli-0.1.11.3/ara_cli/ara_subcommands/fetch_scripts.py

@@ -0,0 +1,8 @@
+import typer
+from ara_cli.commands.fetch_scripts_command import FetchScriptsCommand
+
+def register(app: typer.Typer):
+    @app.command(name="fetch-scripts", help="Fetch global scripts into your config directory.")
+    def fetch_scripts():
+        command = FetchScriptsCommand()
+        command.execute()

{ara_cli-0.1.10.7 → ara_cli-0.1.11.3}/ara_cli/chat.py

@@ -1,6 +1,8 @@
 import os
 import argparse
 import cmd2
+import tempfile
+import time
 
 from ara_cli.prompt_handler import send_prompt
 
@@ -11,6 +13,9 @@ from ara_cli.file_loaders.document_file_loader import DocumentFileLoader
 from ara_cli.file_loaders.binary_file_loader import BinaryFileLoader
 from ara_cli.file_loaders.text_file_loader import TextFileLoader
 from ara_cli.chat_agent.agent_process_manager import AgentProcessManager
+from ara_cli.chat_script_runner.script_runner import ScriptRunner
+from ara_cli.chat_script_runner.script_completer import ScriptCompleter
+from ara_cli.chat_script_runner.script_lister import ScriptLister
 
 
 extract_parser = argparse.ArgumentParser()
@@ -37,6 +42,7 @@ load_parser.add_argument(
 class Chat(cmd2.Cmd):
     CATEGORY_CHAT_CONTROL = "Chat control commands"
     CATEGORY_LLM_CONTROL = "Language model controls"
+    CATEGORY_SCRIPT_CONTROL = "Script control commands"
     CATEGORY_AGENT_CONTROL = "Agent control commands"
 
     INTRO = """/***************************************/
@@ -117,6 +123,9 @@ Start chatting (type 'HELP'/'h' for available commands, 'QUIT'/'q' to exit chat
         self.message_buffer = []
         self.config = self._retrieve_ara_config()
         self.template_loader = TemplateLoader(chat_instance=self)
+        self.script_runner = ScriptRunner(chat_instance=self)
+        self.script_lister = ScriptLister()
+        self.script_completer = ScriptCompleter()
 
         # Initialize agent process manager
         self.agent_manager = AgentProcessManager(self)
@@ -148,6 +157,7 @@ Start chatting (type 'HELP'/'h' for available commands, 'QUIT'/'q' to exit chat
         self.aliases["lg"] = "LOAD_GIVENS"
         self.aliases["lb"] = "LOAD_BLUEPRINT"
         self.aliases["lt"] = "LOAD_TEMPLATE"
+        self.aliases["rpy"] = "run_pyscript"
         # Agent control aliases
         self.aliases["a"] = "AGENT_RUN"
         self.aliases["as"] = "AGENT_STOP"
@@ -1117,6 +1127,84 @@ Start chatting (type 'HELP'/'h' for available commands, 'QUIT'/'q' to exit chat
         """Completer for the LOAD_BLUEPRINT command."""
         return self._template_completer(text, "blueprint")
 
+    def _select_script_from_list(self, scripts: list[str], not_found_message: str, prompt: str) -> str | None:
+        """Displays a list of scripts and prompts the user to select one."""
+        if not scripts:
+            self.poutput(not_found_message)
+            return None
+
+        # Sort the scripts alphabetically by their basename for consistent display
+        # Create a list of (basename, full_script_name) tuples for sorting and later retrieval
+        scripts_with_basenames = [(os.path.basename(s), s) for s in scripts]
+        scripts_with_basenames.sort(key=lambda x: x[0].lower()) # Sort by lowercase basename
+
+        for i, (basename, full_script_name) in enumerate(scripts_with_basenames):
+            self.poutput(f"{i + 1}: {basename}")
+
+        try:
+            choice = input(prompt)
+            choice_index = int(choice) - 1
+            if 0 <= choice_index < len(scripts_with_basenames):
+                # Return the full script name from the sorted list
+                return scripts_with_basenames[choice_index][1]
+            else:
+                self.poutput("Invalid choice. Aborting.")
+                return None
+        except (ValueError, EOFError):
+            self.poutput("Invalid input. Aborting.")
+            return None
+
+    @cmd2.with_category(CATEGORY_SCRIPT_CONTROL)
+    def do_run_pyscript(self, arg_list: list):
+        """Run a python script from the chat."""
+        
+        if not arg_list:
+            script_name = ""
+        else:
+            script_name = "".join(arg_list)
+
+        script_map = {
+            "global/*": (self.script_lister.get_global_scripts, "No global scripts found. Have you run 'ara fetch-scripts'?", "global/"),
+            "*": (self.script_lister.get_custom_scripts, "No custom scripts found.", ""),
+            "": (self.script_lister.get_all_scripts, "No scripts found.", "")
+        }
+
+        script_to_run = script_name
+        if script_name in script_map:
+            get_scripts, msg, prefix = script_map[script_name]
+            scripts = get_scripts()
+            
+            prompt = "Please choose a script to run (enter number): "
+
+            chosen_script = self._select_script_from_list(scripts, msg, prompt)
+            if not chosen_script:
+                return
+            
+            if prefix:
+                script_to_run = f"{prefix}{chosen_script}"
+            else:
+                script_to_run = chosen_script
+        
+        if not script_to_run:
+            return
+
+        output = self.script_runner.run_script(script_to_run)
+        if output:
+            self.poutput(output.strip())
+
+    def complete_run_pyscript(self, text, line, begidx, endidx):
+        """Completer for the run_pyscript command."""
+        # Get all scripts: ['custom.py', 'global/global.py']
+        available_scripts = self.script_lister.get_all_scripts()
+        
+        # Add special commands
+        special_commands = ['*', 'global/*', 'global/']
+        
+        possible_completions = sorted(list(set(available_scripts + special_commands)))
+
+        # Filter based on what the user has typed
+        return [s for s in possible_completions if s.startswith(text)]
+
     # ===== AGENT CONTROL COMMANDS =====
 
     @cmd2.with_category(CATEGORY_AGENT_CONTROL)

ara_cli-0.1.11.3/ara_cli/chat_script_runner/script_completer.py

@@ -0,0 +1,23 @@
+from ara_cli.chat_script_runner.script_lister import ScriptLister
+
+class ScriptCompleter:
+    def __init__(self):
+        self.script_lister = ScriptLister()
+
+    def __call__(self, text, line, begidx, endidx):
+        if line.startswith("rpy global/"):
+            return self._complete_global_scripts(text)
+        
+        return self._complete_all_scripts(text)
+
+    def _complete_all_scripts(self, text):
+        all_scripts = self.script_lister.get_all_scripts()
+        if not text:
+            return all_scripts
+        return [s for s in all_scripts if s.startswith(text)]
+
+    def _complete_global_scripts(self, text):
+        global_scripts = self.script_lister.get_global_scripts()
+        if not text:
+            return global_scripts
+        return [s for s in global_scripts if s.startswith(text)]

ara_cli-0.1.11.3/ara_cli/chat_script_runner/script_finder.py

@@ -0,0 +1,36 @@
+import os
+from ara_cli.ara_config import ConfigManager
+
+
+class ScriptFinder:
+    def __init__(self):
+        self.config = ConfigManager.get_config()
+
+    def get_custom_scripts_dir(self):
+        return os.path.join(self.config.local_prompt_templates_dir, "custom-scripts")
+
+    def get_global_scripts_dir(self):
+        return os.path.join(self.config.local_prompt_templates_dir, "global-scripts")
+
+    def find_script(self, script_name: str) -> str | None:
+        # Handle explicit global path for backward compatibility or specific cases
+        if script_name.startswith("global/"):
+            script_path = os.path.join(
+                self.get_global_scripts_dir(), script_name.replace("global/", ""))
+            if os.path.exists(script_path):
+                return script_path
+            return None
+
+        # 1. Search in custom-scripts first (allows overriding global scripts)
+        custom_script_path = os.path.join(
+            self.get_custom_scripts_dir(), script_name)
+        if os.path.exists(custom_script_path):
+            return custom_script_path
+
+        # 2. If not found in custom, fall back to global-scripts
+        global_script_path = os.path.join(
+            self.get_global_scripts_dir(), script_name)
+        if os.path.exists(global_script_path):
+            return global_script_path
+
+        return None

ara_cli-0.1.11.3/ara_cli/chat_script_runner/script_lister.py

@@ -0,0 +1,33 @@
+import os
+import glob
+from ara_cli.chat_script_runner.script_finder import ScriptFinder
+
+
+class ScriptLister:
+    def __init__(self):
+        self.script_finder = ScriptFinder()
+
+    def get_all_scripts(self):
+        custom_scripts = self.get_custom_scripts()
+        global_scripts = self.get_global_scripts()
+
+        # Combine custom and global scripts for direct, unprefixed access
+        direct_access_scripts = set(custom_scripts + global_scripts)
+
+        # Add global scripts with the 'global/' prefix for explicit access / backward compatibility
+        prefixed_global_scripts = {f"global/{s}" for s in global_scripts}
+
+        # Return a single, sorted, and unique list for autocompletion
+        return sorted(list(direct_access_scripts.union(prefixed_global_scripts)))
+
+    def get_custom_scripts(self):
+        custom_scripts_dir = self.script_finder.get_custom_scripts_dir()
+        if not custom_scripts_dir or not os.path.isdir(custom_scripts_dir):
+            return []
+        return [os.path.basename(f) for f in glob.glob(os.path.join(custom_scripts_dir, "*.py"))]
+
+    def get_global_scripts(self):
+        global_scripts_dir = self.script_finder.get_global_scripts_dir()
+        if not global_scripts_dir or not os.path.isdir(global_scripts_dir):
+            return []
+        return [os.path.basename(f) for f in glob.glob(os.path.join(global_scripts_dir, "*.py"))]

ara_cli-0.1.11.3/ara_cli/chat_script_runner/script_runner.py

@@ -0,0 +1,32 @@
+import os
+import subprocess
+from ara_cli.chat_script_runner.script_finder import ScriptFinder
+from ara_cli.chat_script_runner.script_lister import ScriptLister
+
+class ScriptRunner:
+    def __init__(self, chat_instance):
+        self.chat_instance = chat_instance
+        self.script_finder = ScriptFinder()
+        self.script_lister = ScriptLister()
+
+    def run_script(self, script_name: str):
+        script_path = self.script_finder.find_script(script_name)
+        if not script_path:
+            return f"Script '{script_name}' not found."
+
+        try:
+            result = subprocess.run(
+                ["python", script_path],
+                capture_output=True,
+                text=True,
+                check=True,
+            )
+            return result.stdout
+        except subprocess.CalledProcessError as e:
+            return f"Error running script: {e}\n{e.stderr}"
+
+    def get_available_scripts(self):
+        return self.script_lister.get_all_scripts()
+
+    def get_global_scripts(self):
+        return self.script_lister.get_global_scripts()

ara_cli-0.1.11.3/ara_cli/commands/fetch_scripts_command.py

@@ -0,0 +1,43 @@
+import os
+import shutil
+from ara_cli.commands.command import Command
+from ara_cli.ara_config import ConfigManager
+from ara_cli.directory_navigator import DirectoryNavigator
+
+class FetchScriptsCommand(Command):
+    def __init__(self, output=None):
+        self.output = output or print
+        self.config = ConfigManager.get_config()
+
+    def execute(self):
+        navigator = DirectoryNavigator()
+        original_directory = os.getcwd()
+        navigator.navigate_to_target()
+        os.chdir('..')
+
+        global_scripts_dir = self._get_global_scripts_dir()
+        global_scripts_config_dir = self._get_global_scripts_config_dir()
+
+        if not os.path.exists(global_scripts_dir):
+            self.output("Global scripts directory not found.")
+            os.chdir(original_directory)
+            return
+
+        if not os.path.exists(global_scripts_config_dir):
+            os.makedirs(global_scripts_config_dir)
+
+        for item in os.listdir(global_scripts_dir):
+            source = os.path.join(global_scripts_dir, item)
+            destination = os.path.join(global_scripts_config_dir, item)
+            if os.path.isfile(source):
+                shutil.copy2(source, destination)
+                self.output(f"Copied {item} to global scripts directory.")
+
+        os.chdir(original_directory)
+
+    def _get_global_scripts_dir(self):
+        base_path = os.path.dirname(os.path.dirname(__file__))
+        return os.path.join(base_path, "templates", "global-scripts")
+
+    def _get_global_scripts_config_dir(self):
+        return os.path.join(self.config.local_prompt_templates_dir, "global-scripts")

ara_cli-0.1.11.3/ara_cli/templates/global-scripts/hello_global.py

@@ -0,0 +1 @@
+print('Hello Global')

ara_cli-0.1.11.3/ara_cli/templates/prompt-modules/commands/add_scenarios_for_new_behaviour.feature_creation_agent.commands.md

@@ -0,0 +1 @@
+Given the existing feature file {feature_file_path} and the implementation change described in {implementation_change_reference} (for example, a specific source file or change request), create new scenarios and update the feature file directly so that the new behaviour is fully covered.

ara_cli-0.1.11.3/ara_cli/templates/prompt-modules/commands/align_feature_with_implementation_changes.interview_agent.commands.md

@@ -0,0 +1 @@
+I have changed the implementation file {updated_implementation_file_path} by adding new functionality after the existing comment markers. Update the related feature file {feature_file_path} so that the Then-steps match the new behaviour and, if needed, create additional scenarios to cover the new logic.

ara_cli-0.1.11.3/ara_cli/templates/prompt-modules/commands/analyze_codebase_and_plan_tasks.interview_agent.commands.md

@@ -0,0 +1 @@
+Analyse the codebase and all related feature files using the semantic search tool {codebase_collector_tool_name} (either codebase_collector_features or codebase_collector_frontend, depending on the project). Use a detailed semantic query {codebase_query_description} derived from the user story in {user_story_task_file_path}. Based on the retrieved context, list which new tasks are needed for code changes, tests, and documentation. Then, use the appropriate agents (autocoder_behavetests_agent, autocoder_agent, documentation_agent, feature_creation_agent, test_generation_agent, web_autocoder_agent) so that the necessary feature files and tests are created or updated according to your findings.

ara_cli-0.1.11.3/ara_cli/templates/prompt-modules/commands/choose_best_parent_artefact.interview_agent.commands.md

@@ -0,0 +1 @@
+Using the find_the_best_suited_parent_artefact tool for the given artifact, determine which artefact is best suited to capture the value. Explain your reasoning and, if needed, propose concrete artefact names or formats.

ara_cli-0.1.11.3/ara_cli/templates/prompt-modules/commands/create_tasks_from_artefact_content.interview_agent.commands.md

@@ -0,0 +1 @@
+From the artefact content at {example_artefact_file_path}, create a set of implementation tasks with the exact specified names and content and assign them logically to the responsible user {assignee_identifier}. Do not modify the provided task texts; just materialise them as individual task entries in the appropriate location.

ara_cli-0.1.11.3/ara_cli/templates/prompt-modules/commands/create_tests_for_uncovered_modules.test_generation_agent.commands.md

@@ -0,0 +1 @@
+Create pytest tests for all modules that currently have 0% coverage according to the coverage report at {coverage_report_path}. Generate test files for each uncovered module in {tests_output_directory}, ensuring that basic behaviour and key error cases are tested.

ara_cli-0.1.11.3/ara_cli/templates/prompt-modules/commands/derive_features_from_video_description.feature_creation_agent.commands.md

@@ -0,0 +1 @@
+Based on the information provided in the video described in {video_description_source} (or the attached video), derive the matching feature files and their content under {features_directory_path}. Use the parent user story in {user_story_file_path} and the existing matching rules in {matching_rules_file_path}, then update existing feature files or create new ones so that all described behaviours are covered.

ara_cli-0.1.11.3/ara_cli/templates/prompt-modules/commands/describe_agent_capabilities.agent.commands.md

@@ -0,0 +1 @@
+Describe in detail what this agent can do for the user. Focus on supported capabilities, limitations, and typical workflows, and output the description as user-facing documentation. Do not use any tools.

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

@@ -0,0 +1,4 @@
+### COMMANDS FOR ...
+Your job is now:
+* <main list for mandotory commands>
+* ...

ara_cli-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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-0.1.11.3/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.