ara-cli 0.1.9.77__py3-none-any.whl → 0.1.9.79__py3-none-any.whl

ara_cli/prompt_handler.py

@@ -25,9 +25,10 @@ class LLMSingleton:
 
         if not selected_config:
             raise ValueError(f"No configuration found for the model: {model_id}")
-
+        if not isinstance(selected_config, LLMConfigItem):
+            selected_config = LLMConfigItem(**selected_config)
         LLMSingleton._model = model_id
-        
+
         # Typesafe for None values inside the config.
         self.config_parameters = selected_config.model_dump(exclude_none=True)
 

ara_cli/version.py

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

ara_cli-0.1.9.79.dist-info/METADATA

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: ara_cli
+Version: 0.1.9.79
+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 Behavior-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.77.dist-info → ara_cli-0.1.9.79.dist-info}/RECORD

@@ -25,13 +25,13 @@ ara_cli/list_filter.py,sha256=qKGwwQsrWe7L5FbdxEbBYD1bbbi8c-RMypjXqXvLbgs,5291
 ara_cli/output_suppressor.py,sha256=nwiHaQLwabOjMoJOeUESBnZszGMxrQZfJ3N2OvahX7Y,389
 ara_cli/prompt_chat.py,sha256=kd_OINDQFit6jN04bb7mzgY259JBbRaTaNp9F-webkc,1346
 ara_cli/prompt_extractor.py,sha256=6l1Or7wuFNUDqbMg-NDXpFX-WMi2XV7YGH6hGDvow2o,7557
-ara_cli/prompt_handler.py,sha256=f1J-SAyFQjVgfi0k_Pk4JYotcU_UV4oSrLKoJH-25iM,18576
+ara_cli/prompt_handler.py,sha256=RN409FCUC1VYvML33mcSIvfofEFrHh9iu3W-RY5ti2k,18689
 ara_cli/prompt_rag.py,sha256=ydlhe4CUqz0jdzlY7jBbpKaf_5fjMrAZKnriKea3ZAg,7485
 ara_cli/run_file_lister.py,sha256=XbrrDTJXp1LFGx9Lv91SNsEHZPP-PyEMBF_P4btjbDA,2360
 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=YZaVX1MbXXFpamZLvZnUrGSRq0Szw8TohbROLVLDRkA,146
+ara_cli/version.py,sha256=zdXFVKnlMG8MON6nBwIEaQGfof-CSsHg_QUZgvxglrg,146
 ara_cli/artefact_models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 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
@@ -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.77.dist-info/METADATA,sha256=HYjYn2M6mOc2aYugIuai2mhaV8uaDi2xWtT_x-p3aq0,469
-ara_cli-0.1.9.77.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ara_cli-0.1.9.77.dist-info/entry_points.txt,sha256=v4h7MzysTgSIDYfEo3oj4Kz_8lzsRa3hq-KJHEcLVX8,45
-ara_cli-0.1.9.77.dist-info/top_level.txt,sha256=WM4cLHT5DYUaWzLtRj-gu3yVNFpGQ6lLRI3FMmC-38I,14
-ara_cli-0.1.9.77.dist-info/RECORD,,
+ara_cli-0.1.9.79.dist-info/METADATA,sha256=oYAs-Iw1JNmtk372QFveEt5IBlC5b-tATFRMqQLPxYw,6739
+ara_cli-0.1.9.79.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ara_cli-0.1.9.79.dist-info/entry_points.txt,sha256=v4h7MzysTgSIDYfEo3oj4Kz_8lzsRa3hq-KJHEcLVX8,45
+ara_cli-0.1.9.79.dist-info/top_level.txt,sha256=WM4cLHT5DYUaWzLtRj-gu3yVNFpGQ6lLRI3FMmC-38I,14
+ara_cli-0.1.9.79.dist-info/RECORD,,

ara_cli-0.1.9.77.dist-info/METADATA

@@ -1,18 +0,0 @@
-Metadata-Version: 2.4
-Name: ara_cli
-Version: 0.1.9.77
-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: requires-dist