ara-cli 0.1.9.77__tar.gz → 0.1.9.78__tar.gz

ara_cli-0.1.9.78/PKG-INFO

@@ -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.78/README.md

@@ -0,0 +1,184 @@
+# 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.77 → ara_cli-0.1.9.78}/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.78"   # fith parameter like .0 for local install test purposes only. official numbers should be 4 digit numbers

ara_cli-0.1.9.78/ara_cli.egg-info/PKG-INFO

@@ -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.77 → ara_cli-0.1.9.78}/setup.py

@@ -13,6 +13,9 @@ setup(
     version=version['__version__'],
     packages=find_packages(),
     include_package_data=True,
+    description='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',
+    long_description=open('README.md').read(),
+    long_description_content_type='text/markdown',
     entry_points={
         "console_scripts": [
             "ara = ara_cli.__main__:cli",

ara_cli-0.1.9.77/PKG-INFO

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