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

ara_cli/prompt_extractor.py

@@ -77,42 +77,47 @@ def _perform_extraction_for_block(source_lines, block_start, block_end, force, w
     else:
         artefact_class = _find_artefact_class(content_lines_after_extract)
         if artefact_class:
-            _process_artefact_extraction(artefact_class, content_lines_after_extract, force, write)
+            _process_artefact_extraction(
+                artefact_class, content_lines_after_extract, force, write)
         else:
-            print("No filename or valid artefact found, skipping processing for this block.")
+            print(
+                "No filename or valid artefact found, skipping processing for this block.")
             return None, None
 
-    modified_block_text = original_block_text.replace("# [x] extract", "# [v] extract", 1)
+    modified_block_text = original_block_text.replace(
+        "# [x] extract", "# [v] extract", 1)
     return original_block_text, modified_block_text
 
 
 class FenceDetector:
     """Helper class to detect and match fence blocks."""
-    
+
     def __init__(self, source_lines):
         self.source_lines = source_lines
-    
+
     def is_extract_fence(self, line_num):
         """Check if line is a fence with extract marker."""
         line = self.source_lines[line_num]
         stripped_line = line.strip()
-        
-        is_fence = stripped_line.startswith('```') or stripped_line.startswith('~~~')
+
+        is_fence = stripped_line.startswith(
+            '```') or stripped_line.startswith('~~~')
         if not is_fence:
             return False
-            
+
         if not (line_num + 1 < len(self.source_lines)):
             return False
-            
+
         return self.source_lines[line_num + 1].strip().startswith("# [x] extract")
-    
+
     def find_matching_fence_end(self, start_line):
         """Find the matching end fence for a given start fence."""
         fence_line = self.source_lines[start_line]
         indentation = len(fence_line) - len(fence_line.lstrip())
         stripped_fence_line = fence_line.strip()
         fence_char = stripped_fence_line[0]
-        fence_length = len(stripped_fence_line) - len(stripped_fence_line.lstrip(fence_char))
+        fence_length = len(stripped_fence_line) - \
+            len(stripped_fence_line.lstrip(fence_char))
 
         for i in range(start_line + 1, len(self.source_lines)):
             scan_line = self.source_lines[i]
@@ -120,16 +125,16 @@ class FenceDetector:
 
             if not stripped_scan_line or stripped_scan_line[0] != fence_char:
                 continue
-            
+
             if not all(c == fence_char for c in stripped_scan_line):
                 continue
 
             candidate_indentation = len(scan_line) - len(scan_line.lstrip())
             candidate_length = len(stripped_scan_line)
-            
+
             if candidate_length == fence_length and candidate_indentation == indentation:
                 return i
-        
+
         return -1
 
 
@@ -138,17 +143,19 @@ def _process_document_blocks(source_lines, force, write):
     fence_detector = FenceDetector(source_lines)
     replacements = []
     line_num = 0
-    
+
     while line_num < len(source_lines):
         if not fence_detector.is_extract_fence(line_num):
             line_num += 1
             continue
 
         block_start_line = line_num
-        block_end_line = fence_detector.find_matching_fence_end(block_start_line)
-        
+        block_end_line = fence_detector.find_matching_fence_end(
+            block_start_line)
+
         if block_end_line != -1:
-            print(f"Block found and processed starting on line {block_start_line + 1}.")
+            print(
+                f"Block found and processed starting on line {block_start_line + 1}.")
             original, modified = _perform_extraction_for_block(
                 source_lines, block_start_line, block_end_line, force, write
             )
@@ -157,7 +164,7 @@ def _process_document_blocks(source_lines, force, write):
             line_num = block_end_line + 1
         else:
             line_num += 1
-    
+
     return replacements
 
 
@@ -180,20 +187,21 @@ def _setup_working_directory(relative_to_ara_root):
 
 
 def extract_responses(document_path, relative_to_ara_root=False, force=False, write=False):
-    print(f"Starting extraction from '{document_path}'")
-    
+    print(f"Starting extraction from '{document_path}'", flush=True)
+
     try:
         with open(document_path, 'r', encoding='utf-8', errors='replace') as file:
             content = file.read()
     except FileNotFoundError:
-        print(f"Error: File not found at '{document_path}'. Skipping extraction.")
+        print(
+            f"Error: File not found at '{document_path}'. Skipping extraction.")
         return
 
     cwd = _setup_working_directory(relative_to_ara_root)
-    
+
     source_lines = content.split('\n')
     replacements = _process_document_blocks(source_lines, force, write)
-    
+
     updated_content = _apply_replacements(content, replacements)
 
     os.chdir(cwd)
@@ -201,7 +209,8 @@ def extract_responses(document_path, relative_to_ara_root=False, force=False, wr
         file.write(updated_content)
 
     if replacements:
-        print(f"End of extraction. Found and processed {len(replacements)} blocks in '{os.path.basename(document_path)}'.")
+        print(
+            f"End of extraction. Found and processed {len(replacements)} blocks in '{os.path.basename(document_path)}'.")
 
 
 def modify_and_save_file(response, file_path):
@@ -216,7 +225,8 @@ def modify_and_save_file(response, file_path):
         """)
 
         if filename_from_response != file_path:
-            user_decision = prompt_user_decision("Filename does not match, overwrite? (y/n): ")
+            user_decision = prompt_user_decision(
+                "Filename does not match, overwrite? (y/n): ")
             if user_decision.lower() not in ['y', 'yes']:
                 print("Debug: User chose not to overwrite")
                 print("Skipping block.")
@@ -235,8 +245,11 @@ def prompt_user_decision(prompt):
 
 def determine_should_create(skip_query=False):
     if skip_query:
+        print("[DEBUG] skip_query is True, allowing creation.", flush=True)
         return True
-    user_decision = prompt_user_decision("File does not exist. Create? (y/n): ")
+    print(f"[DEBUG] About to prompt for file creation: File does not exist. Create? (y/n): ", flush=True)
+    user_decision = prompt_user_decision(
+        "File does not exist. Create? (y/n): ")
     if user_decision.lower() in ['y', 'yes']:
         return True
     return False
@@ -267,8 +280,8 @@ def create_prompt_for_file_modification(content_str, filename):
         print(f"WARNING: {filename} for merge prompt creation does not exist.")
         return
 
-    content_of_existing_file = json.dumps(get_file_content(filename))
-    content = json.dumps(content_str)
+    content_of_existing_file = get_file_content(filename)
+    content = content_str
 
     prompt_text = f"""
     * given this new_content: 
@@ -303,7 +316,8 @@ def handle_existing_file(filename, block_content, skip_query=False, write=False)
         create_file_if_not_exist(filename, block_content, skip_query)
 
     elif write:
-        print(f"File {filename} exists. Overwriting without LLM merge as requested.")
+        print(
+            f"File {filename} exists. Overwriting without LLM merge as requested.")
         try:
             directory = os.path.dirname(filename)
             if directory:
@@ -316,7 +330,8 @@ def handle_existing_file(filename, block_content, skip_query=False, write=False)
             print(f"Failed to overwrite file {filename} due to an OS error")
     else:
         print(f"File {filename} exists, creating modification prompt")
-        prompt_text = create_prompt_for_file_modification(block_content, filename)
+        prompt_text = create_prompt_for_file_modification(
+            block_content, filename)
         if prompt_text is None:
             return
 
@@ -335,4 +350,4 @@ def extract_and_save_prompt_results(classifier, param, write=False):
     prompt_log_file = f"ara/{sub_directory}/{param}.data/{classifier}.prompt_log.md"
     print(f"Extract marked sections from: {prompt_log_file}")
 
-    extract_responses(prompt_log_file, write=write)
+    extract_responses(prompt_log_file, write=write)

ara_cli/prompt_handler.py

@@ -10,15 +10,79 @@ import logging
 import warnings
 from io import StringIO
 from contextlib import redirect_stderr
-from langfuse import Langfuse
-from langfuse.api.resources.commons.errors import Error as LangfuseError, NotFoundError
-import litellm
 from ara_cli.classifier import Classifier
 from ara_cli.artefact_creator import ArtefactCreator
 from ara_cli.template_manager import TemplatePathManager
 from ara_cli.ara_config import ConfigManager
 from ara_cli.file_lister import generate_markdown_listing
 
+# Lazy loading for heavy modules - these will be imported on first use
+# Module-level references for backward compatibility with tests that patch these
+litellm = None  # Will be lazily loaded
+Langfuse = None  # Will be lazily loaded
+_logging_configured = False
+
+
+def _configure_logging():
+    """Configure logging for litellm/langfuse - called once on first LLM use."""
+    global _logging_configured
+    if _logging_configured:
+        return
+    _logging_configured = True
+
+    logging.getLogger("LiteLLM").setLevel(logging.CRITICAL)
+    logging.getLogger("litellm").setLevel(logging.CRITICAL)
+    logging.getLogger("LiteLLM Proxy").setLevel(logging.CRITICAL)
+    logging.getLogger("LiteLLM Router").setLevel(logging.CRITICAL)
+    logging.getLogger("langfuse").setLevel(logging.CRITICAL)
+    logging.getLogger("opentelemetry").setLevel(logging.CRITICAL)
+    logging.getLogger("opentelemetry.exporter.otlp.proto.http.trace_exporter").setLevel(
+        logging.CRITICAL
+    )
+    logging.getLogger("httpx").setLevel(logging.CRITICAL)
+    logging.getLogger("httpcore").setLevel(logging.CRITICAL)
+
+
+def _get_litellm():
+    """Lazy load litellm module."""
+    global litellm
+    if litellm is None:
+        _configure_logging()
+        import litellm as _litellm
+
+        _litellm.suppress_debug_info = True
+        _litellm.set_verbose = False
+        litellm = _litellm
+
+        # Apply output filtering only when litellm is loaded
+        from ara_cli.output_suppressor import FilteredStdout
+        import sys
+
+        if not isinstance(sys.stdout, FilteredStdout):
+            sys.stdout = FilteredStdout(sys.stdout)
+    return litellm
+
+
+def _get_langfuse():
+    """Lazy load langfuse module."""
+    global Langfuse
+    if Langfuse is None:
+        _configure_logging()
+        from langfuse import Langfuse as _Langfuse
+
+        Langfuse = _Langfuse
+    return Langfuse
+
+
+def _get_langfuse_errors():
+    """Lazy load langfuse error classes."""
+    from langfuse.api.resources.commons.errors import (
+        Error as LangfuseError,
+        NotFoundError,
+    )
+
+    return LangfuseError, NotFoundError
+
 
 class LLMSingleton:
     _instance = None
@@ -51,6 +115,7 @@ class LLMSingleton:
 
         captured_stderr = StringIO()
         with redirect_stderr(captured_stderr):
+            Langfuse = _get_langfuse()
             self.langfuse = Langfuse(
                 public_key=langfuse_public_key,
                 secret_key=langfuse_secret_key,
@@ -218,14 +283,43 @@ def send_prompt(prompt, purpose="default"):
     with LLMSingleton.get_instance().langfuse.start_as_current_span(
         name="send_prompt"
     ) as span:
+        # Sanitize prompt for logging (remove base64 image data)
+        def sanitize_message(msg):
+            import copy
+
+            if not isinstance(msg, dict):
+                return msg
+
+            clean_msg = copy.deepcopy(msg)
+            content = clean_msg.get("content")
+
+            if isinstance(content, list):
+                new_content = []
+                for item in content:
+                    if item.get("type") == "image_url":
+                        # Replace image_url with text placeholder to avoid Langfuse parsing errors on invalid base64
+                        new_content.append(
+                            {
+                                "type": "text",
+                                "text": "[IMAGE DATA TRUNCATED FOR LOGGING]",
+                            }
+                        )
+                    else:
+                        new_content.append(item)
+                clean_msg["content"] = new_content
+            return clean_msg
+
+        sanitized_prompt = [sanitize_message(msg) for msg in prompt]
+
         span.update_trace(
-            input={"prompt": prompt, "purpose": purpose, "model": model_info}
+            input={"prompt": sanitized_prompt, "purpose": purpose, "model": model_info}
         )
 
         config_parameters.pop("provider", None)
 
         filtered_prompt = [msg for msg in prompt if _is_valid_message(msg)]
 
+        litellm = _get_litellm()
         completion = litellm.completion(
             **config_parameters, messages=filtered_prompt, stream=True
         )
@@ -274,13 +368,12 @@ def describe_image(image_path: str) -> str:
             describe_image_prompt = (
                 langfuse_prompt.prompt if langfuse_prompt.prompt else None
             )
-        except (LangfuseError, NotFoundError, Exception) as e:
-            logging.info(f"Could not fetch Langfuse prompt: {e}")
+        except Exception as e:
+            # Silently fallback - no need to show error for describe-image prompt
             describe_image_prompt = None
 
         # Fallback to default prompt if Langfuse prompt is not available
         if not describe_image_prompt:
-            logging.info("Using default describe-image prompt.")
             describe_image_prompt = (
                 "Please describe this image in detail. If it contains text, transcribe it exactly. "
                 "If it's a diagram or chart, explain its structure and content. If it's a photo or illustration, "
@@ -538,7 +631,11 @@ def extract_and_load_markdown_files(md_prompt_file_path):
             elif "[x]" in line:
                 relative_path = line.split("]")[-1].strip()
                 # Use os.path.join for OS-safe joining, then normalize
-                full_rel_path = os.path.join(*header_stack, relative_path) if header_stack else relative_path
+                full_rel_path = (
+                    os.path.join(*header_stack, relative_path)
+                    if header_stack
+                    else relative_path
+                )
                 path_accumulator.append(_norm(full_rel_path))
     return path_accumulator
 
@@ -650,19 +747,28 @@ def collect_file_content_by_extension(prompt_data_path, extensions):
 
 
 def prepend_system_prompt(message_list):
+    from ara_cli.error_handler import AraError, ErrorLevel, ErrorHandler
+
     try:
         langfuse_prompt = LLMSingleton.get_instance().langfuse.get_prompt(
             "ara-cli/system-prompt"
         )
         system_prompt = langfuse_prompt.prompt if langfuse_prompt.prompt else None
-    except (LangfuseError, NotFoundError, Exception) as e:
-        logging.info(f"Could not fetch Langfuse system prompt: {e}")
+    except Exception as e:
+        # Show user-friendly info message about Langfuse connection issue
+        info_error = AraError(
+            message="Langfuse connection failed. Using default system prompt.",
+            error_code=0,
+            level=ErrorLevel.INFO,
+        )
+        ErrorHandler().report_error(info_error)
         system_prompt = None
 
     # Fallback to default prompt if Langfuse prompt is not available
     if not system_prompt:
-        logging.info("Using default system prompt.")
-        system_prompt = "You are a helpful assistant that can process both text and images."
+        system_prompt = (
+            "You are a helpful assistant that can process both text and images."
+        )
 
     # Prepend the system prompt
     system_prompt_message = {"role": "system", "content": system_prompt}
@@ -695,7 +801,9 @@ def append_images_to_message(message, image_data_list):
         message["content"].extend(image_data_list)
     else:
         # If somehow content is not list or str, coerce to list
-        message["content"] = [{"type": "text", "text": str(message_content)}] + image_data_list
+        message["content"] = [
+            {"type": "text", "text": str(message_content)}
+        ] + image_data_list
 
     logger.debug(f"Updated message content with {len(image_data_list)} images")
 
@@ -818,9 +926,7 @@ def generate_config_prompt_global_givens_file(
         return
 
     dir_list = [path for d in config.global_dirs for path in d.values()]
-    print(
-        f"used {dir_list} for global prompt givens file listing with absolute paths"
-    )
+    print(f"used {dir_list} for global prompt givens file listing with absolute paths")
     generate_global_markdown_listing(
         dir_list, config.ara_prompt_given_list_includes, config_prompt_givens_path
-    )
+    )

ara_cli/tag_extractor.py

@@ -6,6 +6,7 @@ from ara_cli.artefact_models.artefact_data_retrieval import (
     artefact_tags_retrieval,
 )
 
+
 class TagExtractor:
     def __init__(self, file_system=None):
         self.file_system = file_system or os
@@ -53,16 +54,16 @@ class TagExtractor:
         """Collect all tags from an artefact including user tags and author."""
         all_tags = []
         all_tags.extend(artefact.tags)
-        
+
         if artefact.status:
             all_tags.append(artefact.status)
-            
+
         user_tags = [f"user_{tag}" for tag in artefact.users]
         all_tags.extend(user_tags)
-        
-        if hasattr(artefact, 'author') and artefact.author:
+
+        if hasattr(artefact, "author") and artefact.author:
             all_tags.append(artefact.author)
-            
+
         return [tag for tag in all_tags if tag is not None]
 
     def _add_tags_to_groups(self, tag_groups, tags):
@@ -92,7 +93,7 @@ class TagExtractor:
         if navigate_to_target:
             navigator.navigate_to_target()
 
-        artefacts = ArtefactReader.read_artefacts()
+        artefacts = ArtefactReader(self.file_system).read_artefacts()
 
         filtered_artefacts = filter_list(
             list_to_filter=artefacts,
@@ -109,4 +110,4 @@ class TagExtractor:
         else:
             self.add_to_tags_set(tag_groups, filtered_artefacts)
 
-        return tag_groups
+        return tag_groups

ara_cli/template_loader.py

@@ -4,6 +4,7 @@ import glob
 from ara_cli.template_manager import TemplatePathManager
 from ara_cli.ara_config import ConfigManager
 from ara_cli.directory_navigator import DirectoryNavigator
+from . import ROLE_PROMPT
 
 
 class TemplateLoader:
@@ -171,7 +172,7 @@ class TemplateLoader:
         with open(chat_file_path, 'r', encoding='utf-8') as file:
             lines = file.readlines()
 
-        prompt_tag = f"# {Chat.ROLE_PROMPT}:"
+        prompt_tag = f"# {ROLE_PROMPT}:"
         if Chat.get_last_role_marker(lines) == prompt_tag:
             return
 

ara_cli/template_manager.py

@@ -5,6 +5,7 @@ from shutil import copy
 from ara_cli.classifier import Classifier
 from ara_cli.directory_navigator import DirectoryNavigator
 from ara_cli.artefact_models.artefact_templates import template_artefact_of_type
+from ara_cli.constants import VALID_ASPECTS
 
 
 class TemplatePathManager:
@@ -27,7 +28,10 @@ class TemplatePathManager:
         base_path = self.get_template_base_path_aspects()
         return [
             (base_path / f"template.{aspect}.md", f"{aspect}.md"),
-            (base_path / f"template.{aspect}.exploration.md", f"{aspect}.exploration.md")
+            (
+                base_path / f"template.{aspect}.exploration.md",
+                f"{aspect}.exploration.md",
+            ),
         ]
 
     def get_template_content(self, classifier):
@@ -63,7 +67,9 @@ class ArtefactFileManager:
                 os.mkdir(data_dir)
             os.chdir(data_dir)
         else:
-            raise ValueError(f"File {artefact_file_path} does not exist. Please create it first.")
+            raise ValueError(
+                f"File {artefact_file_path} does not exist. Please create it first."
+            )
 
     def copy_aspect_templates_to_directory(self, aspect, print_relative_to=""):
         """Copies the templates for the given aspect to the current directory."""
@@ -84,7 +90,9 @@ class ArtefactFileManager:
         steps_file_path = f"features/steps/{artefact_name}_steps.py"
 
         behave_command = f"behave features/{artefact_name}.feature"
-        result = subprocess.run(behave_command, shell=True, capture_output=True, text=True)
+        result = subprocess.run(
+            behave_command, shell=True, capture_output=True, text=True
+        )
 
         # Stderr command output needs to be reduced to only given-when-then statements
         if len(result.stderr) == 0:
@@ -94,26 +102,34 @@ class ArtefactFileManager:
 
     def format_behave_command_output(self, raw_result):
         # Split the input string by lines
-        lines = raw_result.split('\n')
+        lines = raw_result.split("\n")
 
         # Find the first given/when/then and last raise NotImplementedError line
         keywords = ["@given", "@when", "@then"]
-        start_index = next(i for i, line in enumerate(lines) if any(keyword in line for keyword in keywords))
-        end_index = next(i for i, line in reversed(list(enumerate(lines))) if "raise NotImplementedError" in line)
+        start_index = next(
+            i
+            for i, line in enumerate(lines)
+            if any(keyword in line for keyword in keywords)
+        )
+        end_index = next(
+            i
+            for i, line in reversed(list(enumerate(lines)))
+            if "raise NotImplementedError" in line
+        )
 
         # Extract the relevant given-when-then portion
-        formatted_code = '\n'.join(lines[start_index:end_index + 1])
+        formatted_code = "\n".join(lines[start_index : end_index + 1])
         return formatted_code
 
     def save_behave_steps_to_file(self, artefact_name, behave_steps):
         self.navigator.navigate_to_target()
         file_path = f"features/steps/{artefact_name}_steps.py"
-        with open(file_path, 'w', encoding='utf-8') as file:
+        with open(file_path, "w", encoding="utf-8") as file:
             file.write(behave_steps)
 
 
 class SpecificationBreakdownAspects:
-    VALID_ASPECTS = ['technology', 'concept', 'persona', 'customer', 'step']
+    VALID_ASPECTS = VALID_ASPECTS
 
     def __init__(self):
         self.file_manager = ArtefactFileManager()
@@ -123,34 +139,49 @@ class SpecificationBreakdownAspects:
         if artefact_name in Classifier.valid_classifiers:
             raise ValueError(f"{artefact_name} is not a valid artefact name")
 
-        if not Classifier.is_valid_classifier(classifier) or classifier in self.VALID_ASPECTS:
+        if (
+            not Classifier.is_valid_classifier(classifier)
+            or classifier in self.VALID_ASPECTS
+        ):
             raise ValueError(f"{classifier} is not a valid classifier.")
 
         if aspect not in self.VALID_ASPECTS:
-            raise ValueError(f"{aspect} does not exist. Please choose one of the {self.VALID_ASPECTS} list.")
-
-
-    def create(self, artefact_name='artefact_name', classifier='classifier', aspect='specification_breakdown_aspect'):
+            raise ValueError(
+                f"{aspect} does not exist. Please choose one of the {self.VALID_ASPECTS} list."
+            )
+
+    def create(
+        self,
+        artefact_name="artefact_name",
+        classifier="classifier",
+        aspect="specification_breakdown_aspect",
+    ):
         original_directory = os.getcwd()
         navigator = DirectoryNavigator()
         navigator.navigate_to_target()
 
         self.validate_input(artefact_name, classifier, aspect)
-        artefact_file_path = self.file_manager.get_artefact_file_path(artefact_name, classifier)
+        artefact_file_path = self.file_manager.get_artefact_file_path(
+            artefact_name, classifier
+        )
         data_dir = self.file_manager.get_data_directory_path(artefact_name, classifier)
         self.file_manager.create_directory(artefact_file_path, data_dir)
-        self.file_manager.copy_aspect_templates_to_directory(aspect, print_relative_to=original_directory)
-        
-        if (aspect == "step"):
+        self.file_manager.copy_aspect_templates_to_directory(
+            aspect, print_relative_to=original_directory
+        )
+
+        if aspect == "step":
             # Instead of generating from behave command, read from the template file
             template_file_path = f"{aspect}.md"
             try:
-                with open(template_file_path, 'r', encoding='utf-8') as file:
+                with open(template_file_path, "r", encoding="utf-8") as file:
                     steps_content = file.read()
-                self.file_manager.save_behave_steps_to_file(artefact_name, steps_content)
+                self.file_manager.save_behave_steps_to_file(
+                    artefact_name, steps_content
+                )
             except FileNotFoundError:
                 # Fallback to the original behavior if template doesn't exist
                 steps = self.file_manager.generate_behave_steps(artefact_name)
                 self.file_manager.save_behave_steps_to_file(artefact_name, steps)
 
-        os.chdir(original_directory)
+        os.chdir(original_directory)

ara_cli/templates/global-scripts/hello_global.py

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

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