ara-cli 0.1.9.93__py3-none-any.whl → 0.1.9.95__py3-none-any.whl

ara_cli/file_loaders/image_processor.py

@@ -0,0 +1,89 @@
+import os
+import base64
+import tempfile
+import requests
+from typing import Optional, Tuple
+import re
+from ara_cli.prompt_handler import describe_image
+
+
+class ImageProcessor:
+    """Handles image processing operations"""
+    
+    @staticmethod
+    def process_base64_image(image_ref: str, base64_pattern: re.Pattern) -> Optional[Tuple[str, str]]:
+        """Process base64 encoded image and return description"""
+        base64_match = base64_pattern.match(image_ref)
+        if not base64_match:
+            return None
+            
+        image_format = base64_match.group(1)
+        base64_data = base64_match.group(2)
+        image_data = base64.b64decode(base64_data)
+        
+        # Create a temporary file to send to LLM
+        with tempfile.NamedTemporaryFile(suffix=f'.{image_format}', delete=False) as tmp_file:
+            tmp_file.write(image_data)
+            tmp_file_path = tmp_file.name
+        
+        try:
+            description = describe_image(tmp_file_path)
+            return f"Image: (base64 embedded {image_format} image)\n[{description}]", None
+        finally:
+            os.unlink(tmp_file_path)
+    
+    @staticmethod
+    def process_url_image(image_ref: str) -> Tuple[str, Optional[str]]:
+        """Process image from URL and return description"""
+        if not image_ref.startswith(('http://', 'https://')):
+            return "", None
+            
+        try:
+            response = requests.get(image_ref, timeout=10)
+            response.raise_for_status()
+            
+            # Determine file extension from content-type
+            content_type = response.headers.get('content-type', '')
+            ext = ImageProcessor._get_extension_from_content_type(content_type, image_ref)
+            
+            # Create temporary file
+            with tempfile.NamedTemporaryFile(suffix=ext, delete=False) as tmp_file:
+                tmp_file.write(response.content)
+                tmp_file_path = tmp_file.name
+            
+            try:
+                description = describe_image(tmp_file_path)
+                return f"Image: {image_ref}\n[{description}]", None
+            finally:
+                os.unlink(tmp_file_path)
+                
+        except Exception as e:
+            error_msg = f"Could not download image: {str(e)}"
+            return f"Image: {image_ref}\n[{error_msg}]", error_msg
+    
+    @staticmethod
+    def process_local_image(image_ref: str, base_dir: str) -> Tuple[str, Optional[str]]:
+        """Process local image file and return description"""
+        if os.path.isabs(image_ref):
+            local_image_path = image_ref
+        else:
+            local_image_path = os.path.join(base_dir, image_ref)
+        
+        if os.path.exists(local_image_path):
+            description = describe_image(local_image_path)
+            return f"Image: {image_ref}\n[{description}]", None
+        else:
+            error_msg = f"Image file not found"
+            return f"Image: {image_ref}\n[{error_msg}]", f"Local image not found: {local_image_path}"
+    
+    @staticmethod
+    def _get_extension_from_content_type(content_type: str, url: str) -> str:
+        """Determine file extension from content type or URL"""
+        if 'image/jpeg' in content_type:
+            return '.jpg'
+        elif 'image/png' in content_type:
+            return '.png'
+        elif 'image/gif' in content_type:
+            return '.gif'
+        else:
+            return os.path.splitext(url)[1] or '.png'

ara_cli/file_loaders/markdown_reader.py

@@ -0,0 +1,75 @@
+import os
+import re
+from typing import Optional
+from charset_normalizer import from_path
+from ara_cli.file_loaders.image_processor import ImageProcessor
+
+
+class MarkdownReader:
+    """Handles markdown file reading with optional image extraction"""
+
+    def __init__(self, file_path: str):
+        self.file_path = file_path
+        self.base_dir = os.path.dirname(file_path)
+        self.image_processor = ImageProcessor()
+
+    def read(self, extract_images: bool = False) -> str:
+        """Read markdown file and optionally extract/describe images"""
+        # Detect and use the most appropriate encoding
+        result = from_path(self.file_path).best()
+        if not result:
+            print(f"Failed to detect encoding for {self.file_path}")
+            return ""
+        content = str(result)
+
+        if not extract_images:
+            return content
+
+        return self._process_images(content)
+
+    def _process_images(self, content: str) -> str:
+        """Process all images in markdown content"""
+        # Pattern to match markdown images: ![alt text](url or path)
+        image_pattern = re.compile(r"!\[([^\]]*)\]\(([^\)]+)\)")
+        base64_pattern = re.compile(r"data:image/([^;]+);base64,([^)]+)")
+
+        # Process each image reference
+        for match in image_pattern.finditer(content):
+            image_ref = match.group(2)
+            replacement = self._process_single_image(image_ref, base64_pattern)
+
+            if replacement:
+                content = content.replace(match.group(0), replacement, 1)
+
+        return content
+
+    def _process_single_image(
+        self, image_ref: str, base64_pattern: re.Pattern
+    ) -> Optional[str]:
+        """Process a single image reference"""
+        try:
+            # Try base64 first
+            result = self.image_processor.process_base64_image(
+                image_ref, base64_pattern
+            )
+            if result:
+                return result[0]
+
+            # Try URL
+            result, error = self.image_processor.process_url_image(image_ref)
+            if result:
+                if error:
+                    print(f"Warning: {error}")
+                return result
+
+            # Try local file
+            result, error = self.image_processor.process_local_image(
+                image_ref, self.base_dir
+            )
+            if error:
+                print(f"Warning: {error}")
+            return result
+
+        except Exception as e:
+            print(f"Warning: Could not process image {image_ref}: {e}")
+            return None

ara_cli/file_loaders/text_file_loader.py

@@ -4,21 +4,15 @@ import base64
 import tempfile
 from typing import Optional, Tuple
 import requests
+from charset_normalizer import from_path
 from ara_cli.prompt_handler import describe_image
 from ara_cli.file_loaders.file_loader import FileLoader
 
 
 class TextFileLoader(FileLoader):
     """Loads text files"""
-
-    def load(
-        self,
-        file_path: str,
-        prefix: str = "",
-        suffix: str = "",
-        block_delimiter: str = "",
-        extract_images: bool = False
-    ) -> bool:
+    def load(self, file_path: str, prefix: str = "", suffix: str = "",
+             block_delimiter: str = "", extract_images: bool = False, **kwargs) -> bool:
         """Load text file with optional markdown image extraction"""
 
         is_md_file = file_path.lower().endswith('.md')
@@ -27,8 +21,12 @@ class TextFileLoader(FileLoader):
             reader = MarkdownReader(file_path)
             file_content = reader.read(extract_images=True)
         else:
-            with open(file_path, 'r', encoding='utf-8', errors='replace') as file:
-                file_content = file.read()
+            # Use charset-normalizer to detect encoding
+            encoded_content = from_path(file_path).best()
+            if not encoded_content:
+                print(f"Failed to detect encoding for {file_path}")
+                return False
+            file_content = str(encoded_content)
 
         if block_delimiter:
             file_content = f"{block_delimiter}\n{file_content}\n{block_delimiter}"

ara_cli/global_file_lister.py

@@ -0,0 +1,61 @@
+import os
+import fnmatch
+from typing import List, Dict, Any
+
+# Ağaç yapımız için bir tip tanımı yapalım
+DirTree = Dict[str, Any]
+
+def _build_tree(root_path: str, patterns: List[str]) -> DirTree:
+    """Belirtilen yoldaki dizin yapısını temsil eden iç içe bir sözlük oluşturur."""
+    tree: DirTree = {'files': [], 'dirs': {}}
+    try:
+        for item in os.listdir(root_path):
+            item_path = os.path.join(root_path, item)
+            if os.path.isdir(item_path):
+                subtree = _build_tree(item_path, patterns)
+                # Sadece içinde dosya olan veya dosyası olan alt klasörleri ekle
+                if subtree['files'] or subtree['dirs']:
+                    tree['dirs'][item] = subtree
+            elif os.path.isfile(item_path):
+                # Dosyanın verilen desenlerden herhangi biriyle eşleşip eşleşmediğini kontrol et
+                if any(fnmatch.fnmatch(item, pattern) for pattern in patterns):
+                    tree['files'].append(item)
+    except OSError as e:
+        print(f"Warning: Could not access path {root_path}: {e}")
+    return tree
+
+def _write_tree_to_markdown(md_file, tree: DirTree, level: int):
+    """Ağaç veri yapısını markdown formatında dosyaya yazar."""
+    # Dosyaları girintili olarak yaz
+    indent = '    ' * level
+    for filename in sorted(tree['files']):
+        md_file.write(f"{indent}- [] {filename}\n")
+    
+    # Alt dizinler için başlık oluştur ve recursive olarak devam et
+    for dirname, subtree in sorted(tree['dirs'].items()):
+        # Alt başlıklar için girinti yok, sadece başlık seviyesi artıyor
+        md_file.write(f"{'    ' * (level -1)}{'#' * (level + 1)} {dirname}\n")
+        _write_tree_to_markdown(md_file, subtree, level + 1)
+
+def generate_global_markdown_listing(directories: List[str], file_patterns: List[str], output_file: str):
+    """
+    Global dizinler için hiyerarşik bir markdown dosya listesi oluşturur.
+    En üst başlık olarak mutlak yolu kullanır, alt öğeler için göreceli isimler kullanır.
+    """
+    with open(output_file, 'w', encoding='utf-8') as md_file:
+        for directory in directories:
+            abs_dir = os.path.abspath(directory)
+            
+            if not os.path.isdir(abs_dir):
+                print(f"Warning: Global directory not found: {abs_dir}")
+                md_file.write(f"# {directory}\n")
+                md_file.write(f"    - !! UYARI: Dizin bulunamadı: {abs_dir}\n\n")
+                continue
+
+            tree = _build_tree(abs_dir, file_patterns)
+            
+            # Sadece ağaç boş değilse yaz
+            if tree['files'] or tree['dirs']:
+                md_file.write(f"# {abs_dir}\n")
+                _write_tree_to_markdown(md_file, tree, 1)
+                md_file.write("\n")

ara_cli/prompt_extractor.py

@@ -16,7 +16,7 @@ def extract_code_blocks_md(markdown_text):
     return code_blocks
 
 
-def extract_responses(document_path, relative_to_ara_root=False, skip_queries=False):
+def extract_responses(document_path, relative_to_ara_root=False, force=False, write=False):
     print(f"Debug: Starting extraction from {document_path}")
     block_extraction_counter = 0
 
@@ -50,7 +50,7 @@ def extract_responses(document_path, relative_to_ara_root=False, skip_queries=Fa
             block_lines = block_lines[1:]  # Remove first line again after removing filename line
             block = '\n'.join(block_lines)
 
-            handle_existing_file(file_path, block, skip_queries)
+            handle_existing_file(file_path, block, force, write)
             block_extraction_counter += 1
 
             # Update the markdown content
@@ -79,7 +79,7 @@ def extract_responses(document_path, relative_to_ara_root=False, skip_queries=Fa
             artefact_path = artefact.file_path
             directory = os.path.dirname(artefact_path)
             os.makedirs(directory, exist_ok=True)
-            handle_existing_file(artefact_path, serialized_artefact, skip_queries)
+            handle_existing_file(artefact_path, serialized_artefact, force, write)
 
             os.chdir(original_directory)
 
@@ -182,13 +182,28 @@ def create_prompt_for_file_modification(content_str, filename):
     return prompt_text
 
 
-def handle_existing_file(filename, block_content, skip_query=False):
+def handle_existing_file(filename, block_content, skip_query=False, write=False):
     if not os.path.isfile(filename):
         print(f"File {filename} does not exist, attempting to create")
         create_file_if_not_exist(filename, block_content, skip_query)
+    elif write:
+        print(f"File {filename} exists. Overwriting without LLM merge as requested.")
+        try:
+            directory = os.path.dirname(filename)
+            if directory:
+                os.makedirs(directory, exist_ok=True)
+            with open(filename, 'w', encoding='utf-8', errors='replace') as file:
+                file.write(block_content)
+            print(f"File {filename} overwritten successfully.")
+        except OSError as e:
+            print(f"Error: {e}")
+            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)
+        if prompt_text is None:
+            return
+
         messages = [{"role": "user", "content": prompt_text}]
         response = ""
 
@@ -199,12 +214,12 @@ def handle_existing_file(filename, block_content, skip_query=False):
         modify_and_save_file(response, filename)
 
 
-def extract_and_save_prompt_results(classifier, param):
+def extract_and_save_prompt_results(classifier, param, write=False):
     sub_directory = Classifier.get_sub_directory(classifier)
     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)
+    extract_responses(prompt_log_file, write=write)
 
 
 def update_markdown(original_content, block_content, filename):

ara_cli/prompt_handler.py

@@ -256,6 +256,8 @@ def initialize_prompt_templates(classifier, parameter):
     # Mark the relevant artefact in the givens list
     generate_config_prompt_givens_file(prompt_data_path, "config.prompt_givens.md", artefact_to_mark=f"{parameter}.{classifier}")
 
+    generate_config_prompt_global_givens_file(prompt_data_path, "config.prompt_global_givens.md")
+
 
 def write_template_files_to_config(template_type, config_file, base_template_path):
     template_path = os.path.join(base_template_path, template_type)
@@ -383,10 +385,16 @@ def extract_and_load_markdown_files(md_prompt_file_path):
 
 
 def load_givens(file_path):
-    content = "### GIVENS\n\n"
+    content = ""
     image_data_list = []
     markdown_items = extract_and_load_markdown_files(file_path)
 
+    # Only proceed and add the header if there are marked items to load.
+    if not markdown_items:
+        return "", []
+
+    content = "### GIVENS\n\n"
+
     for item in markdown_items:
         if item.lower().endswith(('.png', '.jpeg', '.jpg')):
             with open(item, "rb") as image_file:
@@ -449,7 +457,7 @@ def collect_file_content_by_extension(prompt_data_path, extensions):
         files = find_files_with_endings(prompt_data_path, [ext])
         for file_name in files:
             file_path = join(prompt_data_path, file_name)
-            if ext == ".prompt_givens.md":
+            if ext in [".prompt_givens.md", ".prompt_global_givens.md"]:
                 givens, image_data = load_givens(file_path)
                 combined_content += givens
                 image_data_list.extend(image_data)
@@ -494,7 +502,7 @@ def create_and_send_custom_prompt(classifier, parameter):
     prompt_data_path = f"ara/{sub_directory}/{parameter}.data/prompt.data"
     prompt_file_path_markdown = join(prompt_data_path, f"{classifier}.prompt.md")
 
-    extensions = [".blueprint.md", ".rules.md", ".prompt_givens.md", ".intention.md", ".commands.md"]
+    extensions = [".blueprint.md", ".rules.md", ".prompt_givens.md", ".prompt_global_givens.md", ".intention.md", ".commands.md"]
     combined_content_markdown, image_data_list = collect_file_content_by_extension(prompt_data_path, extensions)
 
     with open(prompt_file_path_markdown, 'w', encoding='utf-8') as file:
@@ -561,4 +569,16 @@ def generate_config_prompt_givens_file(prompt_data_path, config_prompt_givens_na
 
         # Write the updated listing back to the file
         with open(config_prompt_givens_path, 'w', encoding='utf-8') as file:
-            file.write("".join(updated_listing))
+            file.write("".join(updated_listing))
+
+def generate_config_prompt_global_givens_file(prompt_data_path, config_prompt_givens_name, artefact_to_mark=None):
+    from ara_cli.global_file_lister import generate_global_markdown_listing
+    config_prompt_givens_path = os.path.join(prompt_data_path, config_prompt_givens_name)
+    config = ConfigManager.get_config()
+
+    if not hasattr(config, 'global_dirs') or not config.global_dirs:
+        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")
+    generate_global_markdown_listing(dir_list, config.ara_prompt_given_list_includes, config_prompt_givens_path)

ara_cli/tag_extractor.py

@@ -1,6 +1,10 @@
 import os
 from ara_cli.list_filter import ListFilter, filter_list
-from ara_cli.artefact_lister import ArtefactLister
+from ara_cli.artefact_models.artefact_data_retrieval import (
+    artefact_content_retrieval,
+    artefact_path_retrieval,
+    artefact_tags_retrieval,
+)
 
 
 class TagExtractor:
@@ -10,7 +14,9 @@ class TagExtractor:
     def filter_column(self, tags_set, filtered_artefacts):
         status_tags = {"to-do", "in-progress", "review", "done", "closed"}
 
-        artefacts_to_process = self._get_artefacts_without_status_tags(filtered_artefacts, status_tags)
+        artefacts_to_process = self._get_artefacts_without_status_tags(
+            filtered_artefacts, status_tags
+        )
         self._add_non_status_tags_to_set(tags_set, artefacts_to_process, status_tags)
 
     def _get_artefacts_without_status_tags(self, filtered_artefacts, status_tags):
@@ -28,7 +34,9 @@ class TagExtractor:
 
     def _add_non_status_tags_to_set(self, tags_set, artefacts, status_tags):
         for artefact in artefacts:
-            tags = [tag for tag in (artefact.tags + [artefact.status]) if tag is not None]
+            tags = [
+                tag for tag in (artefact.tags + [artefact.status]) if tag is not None
+            ]
             for tag in tags:
                 if self._is_skipped_tag(tag, status_tags):
                     continue
@@ -36,23 +44,25 @@ class TagExtractor:
 
     def _is_skipped_tag(self, tag, status_tags):
         return (
-            tag in status_tags
-            or tag.startswith("priority_")
-            or tag.startswith("user_")
+            tag in status_tags or tag.startswith("priority_") or tag.startswith("user_")
         )
 
     def add_to_tags_set(self, tags_set, filtered_artefacts):
         for artefact_list in filtered_artefacts.values():
             for artefact in artefact_list:
                 user_tags = [f"user_{tag}" for tag in artefact.users]
-                tags = [tag for tag in (artefact.tags + [artefact.status] + user_tags) if tag is not None]
+                tags = [
+                    tag
+                    for tag in (artefact.tags + [artefact.status] + user_tags)
+                    if tag is not None
+                ]
                 tags_set.update(tags)
 
     def extract_tags(
         self,
         navigate_to_target=False,
         filtered_extra_column=False,
-        list_filter: ListFilter | None = None
+        list_filter: ListFilter | None = None,
     ):
         from ara_cli.template_manager import DirectoryNavigator
         from ara_cli.artefact_reader import ArtefactReader
@@ -66,9 +76,9 @@ class TagExtractor:
         filtered_artefacts = filter_list(
             list_to_filter=artefacts,
             list_filter=list_filter,
-            content_retrieval_strategy=ArtefactLister.artefact_content_retrieval,
-            file_path_retrieval=ArtefactLister.artefact_path_retrieval,
-            tag_retrieval=ArtefactLister.artefact_tags_retrieval
+            content_retrieval_strategy=artefact_content_retrieval,
+            file_path_retrieval=artefact_path_retrieval,
+            tag_retrieval=artefact_tags_retrieval,
         )
 
         unique_tags = set()

ara_cli/template_manager.py

@@ -129,6 +129,7 @@ class SpecificationBreakdownAspects:
         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'):
         original_directory = os.getcwd()
         navigator = DirectoryNavigator()
@@ -139,8 +140,17 @@ class SpecificationBreakdownAspects:
         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"):
-            steps = self.file_manager.generate_behave_steps(artefact_name)
-            self.file_manager.save_behave_steps_to_file(artefact_name, steps)
-
-        os.chdir(original_directory)
+            # 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:
+                    steps_content = file.read()
+                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)

ara_cli/update_config_prompt.py

@@ -103,6 +103,7 @@ def handle_existing_file(file_path, tmp_file_path, generate_file_func, automatic
 
 
 def update_artefact_config_prompt_files(classifier, param, automatic_update=False):
+    from ara_cli.prompt_handler import generate_config_prompt_global_givens_file
     sub_directory = Classifier.get_sub_directory(classifier)
     artefact_data_path = os.path.join("ara", sub_directory, f"{param}.data")
     prompt_data_path = os.path.join(artefact_data_path, "prompt.data")
@@ -111,13 +112,18 @@ def update_artefact_config_prompt_files(classifier, param, automatic_update=Fals
 
     givens_file_name = "config.prompt_givens.md"
     givens_tmp_file_name = "config.prompt_givens_tmp.md"
+    global_givens_file_name = "config.prompt_global_givens.md"
+    global_givens_tmp_file_name = "config.prompt_global_givens_tmp.md"
     template_file_name = "config.prompt_templates.md"
     template_tmp_file_name = "config.prompt_templates_tmp.md"
 
     prompt_config_givens = os.path.join(prompt_data_path, givens_file_name)
     prompt_config_givens_tmp = os.path.join(prompt_data_path, givens_tmp_file_name)
+    prompt_config_global_givens = os.path.join(prompt_data_path, global_givens_file_name)
+    prompt_config_global_givens_tmp = os.path.join(prompt_data_path, global_givens_tmp_file_name)
     prompt_config_templates = os.path.join(prompt_data_path, template_file_name)
     prompt_config_templates_tmp = os.path.join(prompt_data_path, template_tmp_file_name)
 
     handle_existing_file(prompt_config_givens, prompt_config_givens_tmp, generate_config_prompt_givens_file, automatic_update)
-    handle_existing_file(prompt_config_templates, prompt_config_templates_tmp, generate_config_prompt_template_file, automatic_update)
+    handle_existing_file(prompt_config_global_givens, prompt_config_global_givens_tmp, generate_config_prompt_global_givens_file, automatic_update)
+    handle_existing_file(prompt_config_templates, prompt_config_templates_tmp, generate_config_prompt_template_file, automatic_update)

ara_cli/version.py

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

{ara_cli-0.1.9.93.dist-info → ara_cli-0.1.9.95.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ara_cli
-Version: 0.1.9.93
+Version: 0.1.9.95
 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: litellm
@@ -13,6 +13,7 @@ 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
@@ -108,22 +109,22 @@ ara autofix
 
 ## Command Overview
 
-| Action             | Description                                                                 |
-|--------------------|-----------------------------------------------------------------------------|
-| create             | Create a classified artefact with data directory                            |
-| delete             | Delete an artefact and its data directory                                   |
-| rename             | Rename an artefact and its data directory                                   |
-| list, list-tags    | List artefacts, show tags, filter by content, extension, hierarchy etc.     |
-| prompt, chat       | Use AI-powered chat and prompt templates for artefact management            |
-| template           | Print artefact templates in the terminal                                    |
-| fetch-templates    | Download and manage reusable prompt templates                               |
-| read               | Output artefact contents and their full contribution chain                  |
-| reconnect          | Connect artefacts to parent artefacts                                       |
-| read-status, set-status | Query and assign status to artefacts                                   |
-| read-user, set-user     | Query and assign responsible users                                     |
-| classifier-directory    | Show directory of artefact classifiers                                 |
-| scan               | Scan the ARA tree for incompatible or inconsistent artefacts                |
-| autofix            | Automatically correct artefact issues with LLM assistance                   |
+| Action                  | Description                                                             |
+| ----------------------- | ----------------------------------------------------------------------- |
+| create                  | Create a classified artefact with data directory                        |
+| delete                  | Delete an artefact and its data directory                               |
+| rename                  | Rename an artefact and its data directory                               |
+| list, list-tags         | List artefacts, show tags, filter by content, extension, hierarchy etc. |
+| prompt, chat            | Use AI-powered chat and prompt templates for artefact management        |
+| template                | Print artefact templates in the terminal                                |
+| fetch-templates         | Download and manage reusable prompt templates                           |
+| read                    | Output artefact contents and their full contribution chain              |
+| reconnect               | Connect artefacts to parent artefacts                                   |
+| read-status, set-status | Query and assign status to artefacts                                    |
+| read-user, set-user     | Query and assign responsible users                                      |
+| classifier-directory    | Show directory of artefact classifiers                                  |
+| scan                    | Scan the ARA tree for incompatible or inconsistent artefacts            |
+| autofix                 | Automatically correct artefact issues with LLM assistance               |
 
 See `ara -h` for the complete list of commands and usage examples.