ara-cli 0.1.9.93__tar.gz → 0.1.9.95__tar.gz

{ara_cli-0.1.9.93 → ara_cli-0.1.9.95}/PKG-INFO

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

{ara_cli-0.1.9.93 → ara_cli-0.1.9.95}/README.md

@@ -84,22 +84,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.
 

ara_cli-0.1.9.95/ara_cli/__init__.py

@@ -0,0 +1,17 @@
+import warnings
+from .version import __version__
+
+
+whitelisted_commands = ["RERUN", "SEND", "EXTRACT", "LOAD_IMAGE", "CHOOSE_MODEL", "CHOOSE_EXTRACTION_MODEL", "CURRENT_MODEL", "CURRENT_EXTRACTION_MODEL", "LIST_MODELS"]
+
+
+# ANSI escape codes for coloring
+YELLOW = '\033[93m'
+RESET = '\033[0m'
+
+
+def format_warning(message, category, *args, **kwargs):
+    return f'{YELLOW}{category.__name__}: {message}{RESET}\n'
+
+
+warnings.formatwarning = format_warning

{ara_cli-0.1.9.93 → ara_cli-0.1.9.95}/ara_cli/ara_command_action.py

@@ -165,6 +165,7 @@ def prompt_action(args):
     classifier = args.classifier
     param = args.parameter
     init = args.steps
+    write = getattr(args, 'write', False)
 
     def handle_init():
         from ara_cli.prompt_handler import initialize_prompt_templates
@@ -192,7 +193,7 @@ def prompt_action(args):
     def handle_extract():
         from ara_cli.prompt_extractor import extract_and_save_prompt_results
         from ara_cli.update_config_prompt import update_artefact_config_prompt_files
-        extract_and_save_prompt_results(classifier, param)
+        extract_and_save_prompt_results(classifier, param, write=write)
         print(f"automatic update after extract")
         update_artefact_config_prompt_files(classifier, param, automatic_update=True)
 
@@ -294,53 +295,30 @@ def fetch_templates_action(args):
 
 
 def read_action(args):
-    from ara_cli.artefact_reader import ArtefactReader
-    from ara_cli.file_classifier import FileClassifier
+    from ara_cli.commands.read_command import ReadCommand
+    from ara_cli.list_filter import ListFilter
 
     classifier = args.classifier
     artefact_name = args.parameter
     read_mode = args.read_mode
 
-    file_classifier = FileClassifier(os)
-    classified_artefacts = ArtefactReader.read_artefacts()
-    artefacts = classified_artefacts.get(classifier, [])
-    all_artefact_names = [a.title for a in artefacts]
-
-    if artefact_name not in all_artefact_names:
-        suggest_close_name_matches(
-                artefact_name,
-                all_artefact_names
-            )
-        return
-
-    target_artefact = next(filter(
-        lambda x: x.title == artefact_name, artefacts
-    ))
+    list_filter = ListFilter(
+        include_content=args.include_content,
+        exclude_content=args.exclude_content,
+        include_extension=args.include_extension,
+        exclude_extension=args.exclude_extension,
+        include_tags=args.include_tags,
+        exclude_tags=args.exclude_tags
+    )
 
-    artefacts_by_classifier = {classifier: []}
+    command = ReadCommand(
+        classifier=classifier,
+        artefact_name=artefact_name,
+        read_mode=read_mode,
+        list_filter=list_filter
+    )
 
-    match read_mode:
-        case "branch":
-            ArtefactReader.step_through_value_chain(
-                artefact_name=artefact_name,
-                classifier=classifier,
-                artefacts_by_classifier=artefacts_by_classifier,
-                classified_artefacts=classified_artefacts
-            )
-            file_classifier.print_classified_files(artefacts_by_classifier, print_content=True)
-        case "children":
-            artefacts = ArtefactReader.find_children(
-                artefact_name=artefact_name,
-                classifier=classifier,
-                classified_artefacts=classified_artefacts
-            )
-            file_classifier.print_classified_files(
-                files_by_classifier=artefacts,
-                print_content=True
-            )
-        case _:
-            artefacts_by_classifier[classifier].append(target_artefact)
-            file_classifier.print_classified_files(artefacts_by_classifier, print_content=True)
+    command.execute()
 
 
 def reconnect_action(args):
@@ -615,11 +593,13 @@ def extract_action(args):
     from ara_cli.commands.extract_command import ExtractCommand
 
     filename = args.filename
-    skip_queries = args.skip_queries
+    force = args.force
+    write = getattr(args, 'write', False)
     print(filename)
     command = ExtractCommand(
         file_name=filename,
-        skip_queries=skip_queries,
+        force=force,
+        write=write,
         output=lambda msg: print(msg, file=sys.stdout),
         error_output=lambda msg: print(msg, file=sys.stderr)
     )

{ara_cli-0.1.9.93 → ara_cli-0.1.9.95}/ara_cli/ara_command_parser.py

@@ -254,6 +254,13 @@ def prompt_parser(subparsers):
         ).completer = ArtefactCompleter()
         if step == "chat":
             add_chat_arguments(step_parser)
+        if step == "extract":
+            step_parser.add_argument(
+                "-w",
+                "--write",
+                action="store_true",
+                help="Overwrite existing files without using LLM for merging."
+            )
 
 
 def chat_parser(subparsers):
@@ -287,6 +294,8 @@ def read_parser(subparsers):
         "parameter", help="Filename of artefact"
     ).completer = ArtefactCompleter()
 
+    add_filter_flags(read_parser)
+
     branch_group = read_parser.add_mutually_exclusive_group()
     branch_group.add_argument(
         "-b",
@@ -429,10 +438,16 @@ def extract_parser(subparsers):
         help="Input file to extract from."
     )
     extract_parser.add_argument(
-        "--skip-queries", "-s",
+        "--force", "-f",
         action="store_true",
         help="Answer queries with yes when extracting."
     )
+    extract_parser.add_argument(
+        "-w",
+        "--write",
+        action="store_true",
+        help="Overwrite existing files without using LLM for merging."
+    )
 
 
 class CustomHelpFormatter(argparse.HelpFormatter):

{ara_cli-0.1.9.93 → ara_cli-0.1.9.95}/ara_cli/ara_config.py

@@ -6,6 +6,7 @@ from os.path import exists, dirname
 from os import makedirs
 from functools import lru_cache
 import sys
+import warnings
 
 DEFAULT_CONFIG_LOCATION = "./ara/.araconfig/ara_config.json"
 
@@ -21,6 +22,7 @@ class ARAconfig(BaseModel):
         {"source_dir": "./src"},
         {"source_dir": "./tests"}
     ])
+    global_dirs: Optional[List[Dict[str, str]]] = Field(default=[])
     glossary_dir: str = "./glossary"
     doc_dir: str = "./docs"
     local_prompt_templates_dir: str = "./ara/.araconfig"
@@ -162,6 +164,7 @@ def handle_unrecognized_keys(data: dict) -> dict:
             cleaned_data[key] = value
     return cleaned_data
 
+
 # Function to read the JSON file and return an ARAconfig model
 @lru_cache(maxsize=1)
 def read_data(filepath: str) -> ARAconfig:
@@ -170,6 +173,16 @@ def read_data(filepath: str) -> ARAconfig:
     If the file doesn't exist, it creates a default one.
     If the file is invalid, it corrects only the broken parts.
     """
+
+    def warn_on_duplicate_llm_dict_key(ordered_pairs):
+        """Reject duplicate keys."""
+        d = {}
+        for k, v in ordered_pairs:
+            if k in d:
+                warnings.warn(f"Duplicate LLM configuration identifier '{k}'. The previous entry will be removed.", UserWarning)
+            d[k] = v
+        return d
+
     ensure_directory_exists(dirname(filepath))
 
     if not exists(filepath):
@@ -181,7 +194,8 @@ def read_data(filepath: str) -> ARAconfig:
 
     try:
         with open(filepath, "r", encoding="utf-8") as file:
-            data = json.load(file)
+            content = file.read()
+            data = json.loads(content, object_pairs_hook=warn_on_duplicate_llm_dict_key)
     except json.JSONDecodeError as e:
         print(f"Error: Invalid JSON in configuration file: {e}")
         print("Creating a new configuration with defaults...")
@@ -206,7 +220,8 @@ def read_data(filepath: str) -> ARAconfig:
         
         for field_name in error_fields:
             print(f"-> Field '{field_name}' is invalid and will be reverted to its default value.")
-            corrected_data[field_name] = defaults.get(field_name)
+            if field_name in corrected_data:
+                corrected_data[field_name] = defaults.get(field_name)
 
         print("--- End of Error Report ---")
 

{ara_cli-0.1.9.93 → ara_cli-0.1.9.95}/ara_cli/artefact_autofix.py

@@ -144,11 +144,11 @@ def run_agent(prompt, artefact_class):
     # anthropic:claude-4-sonnet-20250514
     agent = Agent(
         model="anthropic:claude-4-sonnet-20250514",
-        result_type=artefact_class,
+        output_type=artefact_class,
         instrument=True,
     )
     result = agent.run_sync(prompt)
-    return result.data
+    return result.output
 
 
 def write_corrected_artefact(file_path, corrected_text):
@@ -196,36 +196,52 @@ def ask_for_correct_contribution(
     return name, classifier
 
 
-def ask_for_contribution_choice(
-    choices, artefact_info: Optional[tuple[str, str]] = None
-) -> Optional[str]:
-    artefact_name, artefact_classifier = (
-        artefact_info if artefact_info else (None, None)
-    )
+def ask_for_contribution_choice(choices: List[str], artefact_info: Optional[tuple[str, str]] = None) -> Optional[str]:
+    artefact_name, artefact_classifier = artefact_info if artefact_info else (None, None)
     message = "Found multiple close matches for the contribution"
     if artefact_name and artefact_classifier:
         message += f" of the {artefact_classifier} '{artefact_name}'"
-    print(f"{message}.")
-    for i, contribution in enumerate(choices):
-        print(f"{i + 1}: {contribution}")
-    choice_number = input(
-        "Please choose the artefact to use for contribution (enter number): "
-    )
+    message += "."
+    return get_user_choice(choices, message)
+
+
+def _has_valid_contribution(artefact: Artefact) -> bool:
+    contribution = artefact.contribution
+    return contribution and contribution.artefact_name and contribution.classifier
+
+
+def get_user_choice(choices: List[str], message: str) -> Optional[str]:
+    """
+    Generic function to present user with a list of choices and return their selection.
+
+    Args:
+        choices: A list of strings representing the choices to display.
+        message: A message to display before listing the choices.
+
+    Returns:
+        The chosen item from the list or None if the input was invalid.
+    """
+    print(message)
+    for i, choice in enumerate(choices):
+        print(f"{i + 1}: {choice}")
+
+    choice_number = input("Please enter your choice (number): ")
+
     try:
         choice_index = int(choice_number) - 1
         if choice_index < 0 or choice_index >= len(choices):
-            print("Invalid choice. Aborting contribution choice.")
+            print("Invalid choice. Aborting operation.")
             return None
-        choice = choices[choice_index]
+        return choices[choice_index]
     except ValueError:
-        print("Invalid input. Aborting contribution choice.")
+        print("Invalid input. Aborting operation.")
         return None
-    return choice
 
 
-def _has_valid_contribution(artefact: Artefact) -> bool:
-    contribution = artefact.contribution
-    return contribution and contribution.artefact_name and contribution.classifier
+def ask_for_rule_choice(matches: List[str]) -> Optional[str]:
+    """Asks the user for a choice between multiple rule matches"""
+    message = "Multiple rule matches found:"
+    return get_user_choice(matches, message)
 
 
 def _update_rule(
@@ -249,6 +265,9 @@ def _update_rule(
         return
     if not closest_rule_match:
         return
+    if len(closest_rule_match) > 1:
+        artefact.contribution.rule = ask_for_rule_choice(closest_rule_match)
+        return
     artefact.contribution.rule = closest_rule_match[0]
 
 

{ara_cli-0.1.9.93 → ara_cli-0.1.9.95}/ara_cli/artefact_creator.py

@@ -106,7 +106,7 @@ class ArtefactCreator:
         if not self.handle_existing_files(file_exists):
             return
 
-        artefact = template_artefact_of_type(classifier, filename, False)
+        artefact = template_artefact_of_type(classifier, filename, True)
 
         if parent_classifier and parent_name:
             artefact.set_contribution(
@@ -114,6 +114,8 @@ class ArtefactCreator:
                 classifier=parent_classifier,
                 rule=rule
             )
+        else:
+            artefact.set_contribution(None, None, None)
 
         artefact_content = artefact.serialize()
         rmtree(dir_path, ignore_errors=True)

{ara_cli-0.1.9.93 → ara_cli-0.1.9.95}/ara_cli/artefact_lister.py

@@ -1,9 +1,13 @@
 from ara_cli.file_classifier import FileClassifier
 from ara_cli.artefact_reader import ArtefactReader
 from ara_cli.file_lister import list_files_in_directory
-from ara_cli.artefact_models.artefact_model import Artefact
 from ara_cli.list_filter import ListFilter, filter_list
 from ara_cli.artefact_fuzzy_search import suggest_close_name_matches
+from ara_cli.artefact_models.artefact_data_retrieval import (
+    artefact_content_retrieval,
+    artefact_path_retrieval,
+    artefact_tags_retrieval,
+)
 import os
 
 
@@ -11,43 +15,18 @@ class ArtefactLister:
     def __init__(self, file_system=None):
         self.file_system = file_system or os
 
-    @staticmethod
-    def artefact_content_retrieval(artefact: Artefact):
-        content = artefact.serialize()
-        return content
-
-    @staticmethod
-    def artefact_path_retrieval(artefact: Artefact):
-        return artefact.file_path
-
-    @staticmethod
-    def artefact_tags_retrieval(artefact: Artefact):
-        final_tags = []
-
-        if not artefact:
-            return []
-
-        final_tags.extend([f"user_{user}" for user in artefact.users])
-        final_tags.append(artefact.status)
-        final_tags.extend(artefact.tags)
-
-        return final_tags
-
     def filter_artefacts(self, classified_files: list, list_filter: ListFilter):
         filtered_list = filter_list(
             list_to_filter=classified_files,
             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,
         )
         return filtered_list
 
     def list_files(
-        self,
-        tags=None,
-        navigate_to_target=False,
-        list_filter: ListFilter | None = None
+        self, tags=None, navigate_to_target=False, list_filter: ListFilter | None = None
     ):
         artefact_list = ArtefactReader.read_artefacts(tags=tags)
         artefact_list = self.filter_artefacts(artefact_list, list_filter)
@@ -60,20 +39,18 @@ class ArtefactLister:
         file_classifier.print_classified_files(filtered_artefact_list)
 
     def list_branch(
-        self,
-        classifier,
-        artefact_name,
-        list_filter: ListFilter | None = None
+        self, classifier, artefact_name, list_filter: ListFilter | None = None
     ):
         file_classifier = FileClassifier(os)
         classified_artefacts = file_classifier.classify_files()
         artefact_info = classified_artefacts.get(classifier, [])
-        matching_artefact_info = [p for p in artefact_info if p["title"] == artefact_name]
+        matching_artefact_info = [
+            p for p in artefact_info if p["title"] == artefact_name
+        ]
 
         if not matching_artefact_info:
             suggest_close_name_matches(
-                artefact_name,
-                [info["title"] for info in artefact_info]
+                artefact_name, [info["title"] for info in artefact_info]
             )
 
         artefacts_by_classifier = {classifier: []}
@@ -82,29 +59,28 @@ class ArtefactLister:
             classifier=classifier,
             artefacts_by_classifier=artefacts_by_classifier,
         )
-        artefacts_by_classifier = self.filter_artefacts(artefacts_by_classifier, list_filter)
+        artefacts_by_classifier = self.filter_artefacts(
+            artefacts_by_classifier, list_filter
+        )
         file_classifier.print_classified_files(artefacts_by_classifier)
 
     def list_children(
-        self,
-        classifier,
-        artefact_name,
-        list_filter: ListFilter | None = None
+        self, classifier, artefact_name, list_filter: ListFilter | None = None
     ):
         file_classifier = FileClassifier(os)
         classified_artefacts = file_classifier.classify_files()
         artefact_info = classified_artefacts.get(classifier, [])
-        matching_artefact_info = [p for p in artefact_info if p["title"] == artefact_name]
+        matching_artefact_info = [
+            p for p in artefact_info if p["title"] == artefact_name
+        ]
 
         if not matching_artefact_info:
             suggest_close_name_matches(
-                artefact_name,
-                [info["title"] for info in artefact_info]
+                artefact_name, [info["title"] for info in artefact_info]
             )
 
         child_artefacts = ArtefactReader.find_children(
-            artefact_name=artefact_name,
-            classifier=classifier
+            artefact_name=artefact_name, classifier=classifier
         )
 
         child_artefacts = self.filter_artefacts(child_artefacts, list_filter)
@@ -112,25 +88,23 @@ class ArtefactLister:
         file_classifier.print_classified_files(child_artefacts)
 
     def list_data(
-        self,
-        classifier,
-        artefact_name,
-        list_filter: ListFilter | None = None
+        self, classifier, artefact_name, list_filter: ListFilter | None = None
     ):
         file_classifier = FileClassifier(os)
         classified_artefact_info = file_classifier.classify_files()
         artefact_info_dict = classified_artefact_info.get(classifier, [])
 
-        matching_info = [info for info in artefact_info_dict if info["title"] == artefact_name]
+        matching_info = [
+            info for info in artefact_info_dict if info["title"] == artefact_name
+        ]
 
         if not matching_info:
             suggest_close_name_matches(
-                artefact_name,
-                [info["title"] for info in artefact_info_dict]
+                artefact_name, [info["title"] for info in artefact_info_dict]
             )
             return
 
         artefact_info = matching_info[0]
-        data_dir = os.path.splitext(artefact_info["file_path"])[0] + '.data'
+        data_dir = os.path.splitext(artefact_info["file_path"])[0] + ".data"
         if os.path.exists(data_dir):
             list_files_in_directory(data_dir, list_filter)

ara_cli-0.1.9.95/ara_cli/artefact_models/artefact_data_retrieval.py

@@ -0,0 +1,23 @@
+from ara_cli.artefact_models.artefact_model import Artefact
+
+
+def artefact_content_retrieval(artefact: Artefact):
+    content = artefact.serialize()
+    return content
+
+
+def artefact_path_retrieval(artefact: Artefact):
+    return artefact.file_path
+
+
+def artefact_tags_retrieval(artefact: Artefact):
+    final_tags = []
+
+    if not artefact:
+        return []
+
+    final_tags.extend([f"user_{user}" for user in artefact.users])
+    final_tags.append(artefact.status)
+    final_tags.extend(artefact.tags)
+
+    return final_tags

{ara_cli-0.1.9.93 → ara_cli-0.1.9.95}/ara_cli/artefact_renamer.py

@@ -1,9 +1,10 @@
-import os
 from functools import lru_cache
 from ara_cli.classifier import Classifier
 from ara_cli.artefact_link_updater import ArtefactLinkUpdater
 from ara_cli.template_manager import DirectoryNavigator
+import os
 import re
+import warnings
 
 
 class ArtefactRenamer:
@@ -22,6 +23,8 @@ class ArtefactRenamer:
         return re.compile(pattern)
 
     def rename(self, old_name, new_name, classifier):
+        import shutil
+
         original_directory = self.navigate_to_target()
 
         if not new_name:
@@ -47,7 +50,8 @@ class ArtefactRenamer:
         if self.file_system.path.exists(new_file_path):
             raise FileExistsError(f"The new file name {new_file_path} already exists.")
         if self.file_system.path.exists(new_dir_path):
-            raise FileExistsError(f"The new directory name {new_dir_path} already exists.")
+            warnings.warn(f"The new directory name {new_dir_path} already exists. It will be replaced by the artefact's data directory or removed entirely.", UserWarning)
+            shutil.rmtree(new_dir_path)
 
         # Perform the renaming of the file and directory
         self.file_system.rename(old_file_path, new_file_path)