ara-cli 0.1.9.76__py3-none-any.whl → 0.1.9.78__py3-none-any.whl

ara_cli/chat.py

@@ -34,6 +34,8 @@ Start chatting (type 'HELP'/'h' for available commands, 'QUIT'/'q' to exit chat
             ".jpg": "image/jpeg",
             ".jpeg": "image/jpeg",
         }
+    
+    DOCUMENT_TYPE_EXTENSIONS = [".docx", ".doc", ".odt", ".pdf"]
 
     def __init__(
         self,
@@ -371,9 +373,52 @@ Start chatting (type 'HELP'/'h' for available commands, 'QUIT'/'q' to exit chat
         with open(self.chat_name, 'a', encoding='utf-8') as chat_file:
             chat_file.write(write_content)
             return True
+    
+    def read_docx(self, file_path):
+        import docx
+        doc = docx.Document(file_path)
+        return '\n'.join(para.text for para in doc.paragraphs)
+
+    def read_pdf(self, file_path):
+        import pymupdf4llm
+        return pymupdf4llm.to_markdown(file_path, write_images=False)
+
+    def read_odt(self, file_path):
+        import pymupdf4llm
+        return pymupdf4llm.to_markdown(file_path, write_images=False)
+
+    @file_exists_check
+    def load_document_file(self, file_path: str, prefix: str = "", suffix: str = "", block_delimiter: str = "```"):
+        import os
+
+        _, ext = os.path.splitext(file_path)
+        ext = ext.lower()
+
+        text_content = ""
+        match ext:
+            case ".docx":
+                text_content = self.read_docx(file_path)
+            case ".pdf":
+                text_content = self.read_pdf(file_path)
+            case ".odt":
+                text_content = self.read_odt(file_path)
+            # Add more cases if needed.
+            case _:
+                print("Unsupported document type.")
+                return False
+
+        if block_delimiter:
+            text_content = f"{block_delimiter}\n{text_content}\n{block_delimiter}"
+
+        write_content = f"{prefix}{text_content}{suffix}\n"
+
+        with open(self.chat_name, 'a', encoding='utf-8') as chat_file:
+            chat_file.write(write_content)
+        return True
 
     def load_file(self, file_name: str, prefix: str = "", suffix: str = "", block_delimiter: str = ""):
         binary_type_mapping = Chat.BINARY_TYPE_MAPPING
+        document_type_extensions = Chat.DOCUMENT_TYPE_EXTENSIONS
 
         file_type = None
         file_name_lower = file_name.lower()
@@ -382,7 +427,16 @@ Start chatting (type 'HELP'/'h' for available commands, 'QUIT'/'q' to exit chat
                 file_type = mime_type
                 break
 
-        if file_type:
+        is_file_document = any(file_name_lower.endswith(ext) for ext in document_type_extensions)
+
+        if is_file_document:
+            return self.load_document_file(
+                file_name=file_name,
+                prefix=prefix,
+                suffix=suffix,
+                block_delimiter=block_delimiter
+            )
+        elif file_type:
             return self.load_binary_file(
                 file_name=file_name,
                 mime_type=file_type,
@@ -503,6 +557,19 @@ Start chatting (type 'HELP'/'h' for available commands, 'QUIT'/'q' to exit chat
             return False
         return True
 
+    @cmd2.with_category(CATEGORY_CHAT_CONTROL)
+    def do_LOAD_DOCUMENT(self, file_name):
+        """Load a document file (PDF, DOCX, DOC, ODT) and append its text content to chat file. Can be given the file name in-line. Will attempt to find the file relative to chat file first, then treat the given path as absolute"""
+        matching_files = self.find_matching_files_to_load(file_name)
+        if not matching_files:
+            return
+
+        for file_path in matching_files:
+            prefix = f"\nFile: {file_path}\n"
+            self.add_prompt_tag_if_needed(self.chat_name)
+            if not os.path.isdir(file_path) and self.load_document_file(file_path, prefix=prefix):
+                print(f"Loaded document file {file_path}")
+
     @cmd2.with_category(CATEGORY_CHAT_CONTROL)
     def do_LOAD_IMAGE(self, file_name):
         """Load an image file and append it to chat file. Can be given the file name in-line. Will attempt to find the file relative to chat file first, then treat the given path as absolute"""

ara_cli/version.py

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

ara_cli-0.1.9.78.dist-info/METADATA

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: ara_cli
+Version: 0.1.9.78
+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
+Requires-Dist: llama-index
+Requires-Dist: llama-index-llms-openai
+Requires-Dist: llama-index-retrievers-bm25
+Requires-Dist: openai
+Requires-Dist: markdown-it-py
+Requires-Dist: json-repair
+Requires-Dist: argparse
+Requires-Dist: argcomplete
+Requires-Dist: cmd2>=2.5
+Requires-Dist: pydantic
+Requires-Dist: pydantic_ai
+Requires-Dist: python-docx
+Requires-Dist: pymupdf4llm
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: summary
+
+# ara-cli
+
+**ara-cli** is a 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. With an intuitive interface and platform-independent implementation in Python, ara-cli enables teams to structure business goals, capabilities, features, user stories, and tasks, and to leverage integrated AI/chat capabilities for requirements engineering, documentation, and process automation.
+
+---
+
+## Features
+
+- **Comprehensive Artefact Management:**  
+  Create, edit, rename, delete, and list all core artefacts of the software development lifecycle: businessgoals, vision, capabilities, keyfeatures, features, epics, userstories, examples, and tasks.
+
+- **Structured Traceability:**  
+  Organize and link artefacts for full traceability from business goals to implementation tasks. Effortlessly navigate artefact hierarchies and dependencies.
+
+- **Integrated AI and Chat:**  
+  Interact with AI language models directly from your terminal. Use chat and prompt commands to assist with documentation, requirements refinement, and artefact management.
+
+- **Prompt Templates:**  
+  Fetch, use, and manage reusable prompt templates for consistent and efficient requirements and documentation workflows.
+
+- **Artefact Status and User Management:**  
+  Assign and query status and responsible users for artefacts to support project coordination and tracking.
+
+- **Automated Quality Assurance:**  
+  Scan artefact trees for inconsistencies and automatically correct issues using integrated LLM-powered autofix functionality.
+
+- **Powerful Listing and Search:**  
+  List artefacts and filter by type, tags, content, contributor relationships, file extensions, and more.
+
+- **Open Source & Platform Independent:**  
+  Implemented in Python and available on PyPI for easy installation and integration into any workflow.
+
+---
+
+## Use Cases
+
+- **Requirements Engineering:**  
+  Capture and structure business requirements and user stories with clear traceability.
+
+- **Agile Development:**  
+  Manage and automate backlog refinement, sprint planning, and task tracking.
+
+- **AI-Enhanced Productivity:**  
+  Use chat and prompt features to accelerate documentation, code review, and knowledge management.
+
+- **Quality Management:**  
+  Ensure artefact consistency and high documentation quality via automated scans and fixes.
+
+---
+
+## Quick Start
+
+Install from PyPI:
+```bash
+pip install ara-cli
+````
+
+Create your first feature artefact:
+
+```bash
+ara create feature login
+```
+
+List all features:
+
+```bash
+ara list --include-extension .feature
+```
+
+Chat with the integrated AI:
+
+```bash
+ara chat
+```
+
+Scan and autofix artefacts:
+
+```bash
+ara scan
+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                   |
+
+See `ara -h` for the complete list of commands and usage examples.
+
+---
+
+## Artefact Structure
+
+ara-cli organizes your project artefacts in a clear directory structure:
+
+```
+./ara/
+   ├── businessgoals/
+   ├── vision/
+   ├── capabilities/
+   ├── keyfeatures/
+   ├── features/
+   ├── epics/
+   ├── userstories/
+   ├── examples/
+   ├── tasks/
+```
+
+---
+
+## Example Workflows
+
+- **Create a new feature and link it to a user story:**
+
+```bash
+ara create feature payment contributes-to userstory checkout
+```
+
+- **Read an artefact's content and its full parent chain:**
+
+```bash
+ara read task implement_api --branch
+```
+
+- **List tasks containing specific content:**
+
+```bash
+ara list --include-extension .task --include-content "API integration"
+```
+
+- **Automate prompt-based LLM interaction for a task:**
+
+```bash
+ara prompt send task implement_api
+ara prompt extract task implement_api
+```
+
+---
+
+## Requirements
+
+- Python 3.8+
+- Platform-independent; tested on Linux, macOS, and Windows
+
+---
+
+## License
+
+This project is open source and freely available under the [MIT License](vector://vector/webapp/LICENSE).
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/ara-cli/
+- **Source code:** \[GitHub link or repository URL\]
+- **Documentation:** \[Link if available\]
+
+---
+
+## Contributing
+
+Contributions, issues, and feature requests are welcome! Please open an issue or submit a pull request via GitHub.
+
+---
+
+**ara-cli — Structure your development. Automate with AI. Build better software.**
+

{ara_cli-0.1.9.76.dist-info → ara_cli-0.1.9.78.dist-info}/RECORD

@@ -1,18 +1,18 @@
 ara_cli/__init__.py,sha256=0zl7IegxTid26EBGLav_fXZ4CCIV3H5TfAoFQiOHjvg,148
-ara_cli/__main__.py,sha256=Z6XYWRLceIoZPvfC-X9EXouSZdtFOOe84kKVWJGA4r4,1861
+ara_cli/__main__.py,sha256=ppfq0FIi4x6ONRzP67784A4BPo2labh8Bd_EExuXo4U,2011
 ara_cli/ara_command_action.py,sha256=J613DUTjRxrPG8Jm-fJcIM0QlZTeULmq9Q7DKkDxJHg,22039
-ara_cli/ara_command_parser.py,sha256=HHuLxGeLjsd3R-JcoWJ5MUgaxXqkECHoqE95amlaVXY,18115
+ara_cli/ara_command_parser.py,sha256=vyxLELnyAZFC2C3v0hH4-r9QBmJ8oIs0hCZukkMFXfc,20136
 ara_cli/ara_config.py,sha256=SgZfQVpqj5JJN4SB0n2IvAH0sKIdS3k1K1Zht2wDywA,8814
-ara_cli/artefact_autofix.py,sha256=XT-OGiznPCX7b6wwxFigHaVt5KzC2pFm6IT8HuwiSVs,17519
+ara_cli/artefact_autofix.py,sha256=WVTiIR-jo4YKmmz4eS3qTFvl45W1YKwAk1XSuz9QX10,20015
 ara_cli/artefact_creator.py,sha256=0Ory6cB-Ahkw-BDNb8QHnTbp_OHGABdkb9bhwcEdcIc,6063
 ara_cli/artefact_deleter.py,sha256=Co4wwCH3yW8H9NrOq7_2p5571EeHr0TsfE-H8KqoOfY,1900
 ara_cli/artefact_fuzzy_search.py,sha256=iBlDqjZf-_D3VUjFf7ZwkiQbpQDcwRndIU7aG_sRTgE,2668
 ara_cli/artefact_link_updater.py,sha256=nKdxTpDKqWTOAMD8viKmUaklSFGWzJZ8S8E8xW_ADuM,3775
 ara_cli/artefact_lister.py,sha256=jhk4n4eqp7hDIq07q43QzS7-36BM3OfZ4EABxCeOGcw,4764
-ara_cli/artefact_reader.py,sha256=E6DMBvbOYf1OoLf-OyLaiB6K2-gd7iHmjoQZU9Rsy6g,6965
+ara_cli/artefact_reader.py,sha256=Pho0_Eqm7kD9CNbVMhKb6mkNM0I3iJiCJXbXmVp1DJU,7827
 ara_cli/artefact_renamer.py,sha256=Hnz_3zD9xxnBa1FHyUE6mIktLk_9ttP2rFRvQIkmz-o,4061
 ara_cli/artefact_scan.py,sha256=msPCm-vPWOAZ_e_z5GylXxq1MtNlmJ4zvKrsdOFCWF4,4813
-ara_cli/chat.py,sha256=CR30wBfKaS8DVCeavEEYFMeCFp3IyRtybQnk-GrCj7U,29341
+ara_cli/chat.py,sha256=Plje33XcOedSx-nmLCkuFIXSqHPIvMcy5I71xYWuYmU,31956
 ara_cli/classifier.py,sha256=zWskj7rBYdqYBGjksBm46iTgVU5IIf2PZsJr4qeiwVU,1878
 ara_cli/codefusionretriever.py,sha256=fCHgXdIBRzkVAnapX-KI2NQ44XbrrF4tEQmn5J6clUI,1980
 ara_cli/codehierachieretriever.py,sha256=Xd3EgEWWhkSf1TmTWtf8X5_YvyE_4B66nRrqarwSiTU,1182
@@ -31,9 +31,9 @@ ara_cli/run_file_lister.py,sha256=XbrrDTJXp1LFGx9Lv91SNsEHZPP-PyEMBF_P4btjbDA,23
 ara_cli/tag_extractor.py,sha256=TGdaQOVnjy25R0zDsAifB67C5oom0Fwo24s0_fr5A_I,3151
 ara_cli/template_manager.py,sha256=YwrN6AYPpl6ZrW8BVQpVXx8yTRf-oNpJUIKeg4NAggs,6606
 ara_cli/update_config_prompt.py,sha256=Oy9vNTw6UhDohyTEfSKkqE5ifEMPlmWNYkKHgUrK_pY,4607
-ara_cli/version.py,sha256=5e5J_7tLNCu-Uoszijp6c5omcE5kBH5OoEtO4VPWHLE,146
+ara_cli/version.py,sha256=8uB-BYYtS-wDJMQLMNnX870pu9lmnUnQMT23kLhsfwE,146
 ara_cli/artefact_models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ara_cli/artefact_models/artefact_load.py,sha256=dNcwZDW2Dk0bts9YnPZ0ESmWD2NbsLIvl4Z-qQeGmTQ,401
+ara_cli/artefact_models/artefact_load.py,sha256=IXzWxP-Q_j_oDGMno0m-OuXCQ7Vd5c_NctshGr4ROBw,621
 ara_cli/artefact_models/artefact_mapping.py,sha256=8aD0spBjkJ8toMAmFawc6UTUxB6-tEEViZXv2I-r88Q,1874
 ara_cli/artefact_models/artefact_model.py,sha256=qSbcrmFWAYgBqcNl9QARI1_uLQJm-TPVgP5q2AEFnjE,15983
 ara_cli/artefact_models/artefact_templates.py,sha256=8HNM-TsNvKgTpruOBs751yRDXJypTiJhc1tkWCiYG7s,9830
@@ -45,7 +45,7 @@ ara_cli/artefact_models/feature_artefact_model.py,sha256=FrR7_xydOmMySAz0QpWgrNF
 ara_cli/artefact_models/issue_artefact_model.py,sha256=v6CpKnkqiUh6Wch2kkEmyyW49c8ysdy1qz8l1Ft9uJA,2552
 ara_cli/artefact_models/keyfeature_artefact_model.py,sha256=J9oXLsCAo22AW31D5Z104y02ss0S0O4tPCcd09zYCD0,4066
 ara_cli/artefact_models/serialize_helper.py,sha256=Wks30wy-UrwJURetydKykLgJkdGRgXFHkDT24vHe5tU,595
-ara_cli/artefact_models/task_artefact_model.py,sha256=OrG7Z0u5QDGoS1a0PlWNxC2n47j9RtNZQo0rz1kNs84,5841
+ara_cli/artefact_models/task_artefact_model.py,sha256=1BSMbz9D-RXvdpdd0RlAr9hUx84Rcuysk2YfQC8Qy14,6046
 ara_cli/artefact_models/userstory_artefact_model.py,sha256=2awH31ROtm7j4T44Bv4cylQDYLQtnfgXZMhDu_pgw-k,6435
 ara_cli/artefact_models/vision_artefact_model.py,sha256=frjaUJj-mmIlVHEhzAQztCGs-CtvNu_odSborgztfzo,5251
 ara_cli/templates/agile.artefacts,sha256=nTA8dp98HWKAD-0qhmNpVYIfkVGoJshZqMJGnphiOsE,7932
@@ -124,14 +124,14 @@ ara_cli/templates/specification_breakdown_files/template.technology.md,sha256=by
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/test_ara_command_action.py,sha256=JTLqXM9BSMlU33OQgrk_sZnoowFJZKZAx8q-st-wa34,25821
 tests/test_ara_config.py,sha256=pvkdPLTzgLkOijil0HaN0mhLC2Rdu4Fu5RfXEyOlRfs,16672
-tests/test_artefact_autofix.py,sha256=K5h-IcPHZHdbLFgQHoto3K4fgX8cNW-ddHgQwCAIlFc,22145
+tests/test_artefact_autofix.py,sha256=pApZ-N0dW8Ujt-cNLbgvd4bhiIIK8oXb-saLf6QlA-8,25022
 tests/test_artefact_fuzzy_search.py,sha256=5Sh3_l9QK8-WHn6JpGPU1b6h4QEnl2JoMq1Tdp2cj1U,1261
 tests/test_artefact_link_updater.py,sha256=biqbEp2jCOz8giv72hu2P2hDfeJfJ9OrVGdAv5d9cK4,2191
 tests/test_artefact_lister.py,sha256=VCEOCgDgnAOeUUgIoGAbWgz60hf9UT-tdHg18LGfB34,22656
 tests/test_artefact_reader.py,sha256=660K-d8ed-j8hulsUB_7baPD2-hhbg9TffUR5yVc4Uo,927
 tests/test_artefact_renamer.py,sha256=lSnKCCfoFGgKhTdDZrEaeBq1xJAak1QoqH5aSeOe9Ro,3494
 tests/test_artefact_scan.py,sha256=uNWgrt7ieZ4ogKACsPqzAsh59JF2BhTKSag31hpVrTQ,16887
-tests/test_chat.py,sha256=BcVCGJjdBHEIXR9l-9Q83fQXP7Hly6yHewY2qEuZ1DE,49161
+tests/test_chat.py,sha256=fUGqpsyilLjwIFNlCAC69pYGEhwRuU6pplywwGJk-K8,54907
 tests/test_classifier.py,sha256=grYGPksydNdPsaEBQxYHZTuTdcJWz7VQtikCKA6BNaQ,1920
 tests/test_directory_navigator.py,sha256=7G0MVrBbtBvbrFUpL0zb_9EkEWi1dulWuHsrQxMJxDY,140
 tests/test_file_classifier.py,sha256=kLWPiePu3F5mkVuI_lK_2QlLh2kXD_Mt2K8KZZ1fAnA,10940
@@ -141,8 +141,8 @@ tests/test_list_filter.py,sha256=fJA3d_SdaOAUkE7jn68MOVS0THXGghy1fye_64Zvo1U,796
 tests/test_tag_extractor.py,sha256=nSiAYlTKZ7TLAOtcJpwK5zTWHhFYU0tI5xKnivLc1dU,2712
 tests/test_template_manager.py,sha256=q-LMHRG4rHkD6ON6YW4cpZxUx9hul6Or8wVVRC2kb-8,4099
 tests/test_update_config_prompt.py,sha256=xsqj1WTn4BsG5Q2t-sNPfu7EoMURFcS-hfb5VSXUnJc,6765
-ara_cli-0.1.9.76.dist-info/METADATA,sha256=DAKMzylR1gaCn0EtuJgjyL-Wx06-D9aST-DSYmEaJp4,415
-ara_cli-0.1.9.76.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ara_cli-0.1.9.76.dist-info/entry_points.txt,sha256=v4h7MzysTgSIDYfEo3oj4Kz_8lzsRa3hq-KJHEcLVX8,45
-ara_cli-0.1.9.76.dist-info/top_level.txt,sha256=WM4cLHT5DYUaWzLtRj-gu3yVNFpGQ6lLRI3FMmC-38I,14
-ara_cli-0.1.9.76.dist-info/RECORD,,
+ara_cli-0.1.9.78.dist-info/METADATA,sha256=j8cLr6oh3gVDON2FJE-pds7Psqspoxsgo008NV6btWw,6739
+ara_cli-0.1.9.78.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ara_cli-0.1.9.78.dist-info/entry_points.txt,sha256=v4h7MzysTgSIDYfEo3oj4Kz_8lzsRa3hq-KJHEcLVX8,45
+ara_cli-0.1.9.78.dist-info/top_level.txt,sha256=WM4cLHT5DYUaWzLtRj-gu3yVNFpGQ6lLRI3FMmC-38I,14
+ara_cli-0.1.9.78.dist-info/RECORD,,

tests/test_artefact_autofix.py

@@ -15,6 +15,7 @@ from ara_cli.artefact_autofix import (
     _has_valid_contribution,
     set_closest_contribution,
     fix_contribution,
+    fix_rule
 )
 from ara_cli.artefact_models.artefact_model import Artefact, ArtefactType, Contribution
 
@@ -60,6 +61,24 @@ def mock_artefact_with_contribution():
     return mock_artefact
 
 
+@pytest.fixture
+def mock_contribution():
+    m = MagicMock()
+    m.artefact_name = "parent_name"
+    m.classifier = "feature"
+    m.rule = "my_rule"
+    return m
+
+@pytest.fixture
+def mock_artefact(mock_contribution):
+    m = MagicMock()
+    m.contribution = mock_contribution
+    m._artefact_type.return_value.value = "requirement"
+    m.title = "my_title"
+    m.serialize.return_value = "serialized-text"
+    return m
+
+
 def test_read_report_file_success():
     """Tests successful reading of the report file."""
     mock_content = "# Artefact Check Report\n- `file.feature`: reason"
@@ -614,4 +633,72 @@ def test_apply_autofix_single_pass(
     assert "Single-pass mode enabled" in output
     assert "Attempt 1/1" in output
     assert "Attempt 2/1" not in output
-    mock_check_file.assert_called_once()
+    mock_check_file.assert_called_once()
+
+
+@patch("ara_cli.artefact_autofix._update_rule")
+@patch("ara_cli.artefact_autofix.populate_classified_artefact_info")
+def test_fix_rule_with_rule(mock_populate, mock_update_rule, mock_artefact, mock_contribution, capsys):
+    # Contribution has a rule
+    artefact_class = MagicMock()
+    artefact_class.deserialize.return_value = mock_artefact
+    mock_populate.return_value = {"info": "dummy"}
+
+    result = fix_rule(
+        file_path="dummy.feature",
+        artefact_text="text",
+        artefact_class=artefact_class,
+        classified_artefact_info={},
+    )
+
+    # deserialize called
+    artefact_class.deserialize.assert_called_once_with("text")
+    # _update_rule called with correct args
+    mock_update_rule.assert_called_once_with(
+        artefact=mock_artefact,
+        name="parent_name",
+        classifier="feature",
+        classified_file_info={"info": "dummy"},
+        delete_if_not_found=True,
+    )
+    # Feedback message contains rule
+    assert "with rule" in capsys.readouterr().out
+    # Result is the serialized text
+    assert result == "serialized-text"
+
+@patch("ara_cli.artefact_autofix._update_rule")
+@patch("ara_cli.artefact_autofix.populate_classified_artefact_info")
+def test_fix_rule_without_rule(mock_populate, mock_update_rule, mock_artefact, mock_contribution, capsys):
+    # Contribution rule becomes None after update
+    mock_contribution.rule = None
+    artefact_class = MagicMock()
+    artefact_class.deserialize.return_value = mock_artefact
+    mock_populate.return_value = {"info": "dummy"}
+
+    result = fix_rule(
+        file_path="dummy.feature",
+        artefact_text="text",
+        artefact_class=artefact_class,
+        classified_artefact_info={},
+    )
+
+    # Feedback message says "without a rule"
+    assert "without a rule" in capsys.readouterr().out
+    assert result == "serialized-text"
+
+@patch("ara_cli.artefact_autofix.populate_classified_artefact_info")
+def test_fix_rule_contribution_none_raises(mock_populate):
+    # artefact.contribution is None: should assert
+    artefact = MagicMock()
+    artefact.contribution = None
+    artefact_class = MagicMock()
+    artefact_class.deserialize.return_value = artefact
+    mock_populate.return_value = {}
+
+    with pytest.raises(AssertionError):
+        fix_rule(
+            file_path="dummy.feature",
+            artefact_text="stuff",
+            artefact_class=artefact_class,
+            classified_artefact_info={},
+        )