ara-cli 0.1.10.5__tar.gz → 0.1.11.1__tar.gz

{ara_cli-0.1.10.5 → ara_cli-0.1.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ara_cli
-Version: 0.1.10.5
+Version: 0.1.11.1
 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: langfuse
@@ -20,6 +20,7 @@ Requires-Dist: pydantic_ai
 Requires-Dist: python-docx
 Requires-Dist: pymupdf4llm
 Requires-Dist: typer
+Requires-Dist: psutil
 Dynamic: description
 Dynamic: description-content-type
 Dynamic: requires-dist
@@ -130,6 +131,35 @@ ara autofix
 
 See `ara -h` for the complete list of commands and usage examples.
 
+---
+## Agent Commands
+
+`ara-cli` includes powerful agent-based capabilities that can be accessed through the interactive chat. These agents can perform complex, multi-step tasks, such as conducting interviews or automating coding workflows.
+
+To use the agent commands, first start an interactive chat session:
+
+```bash
+ara prompt chat <artefact_classifier> <artefact_name>
+```
+
+Once inside the chat, you can use the following commands to manage agents:
+
+| Command          | Shortcut | Description                                       |
+| ---------------- | -------- | ------------------------------------------------- |
+| `AGENT_RUN`      | `a`      | Run an agent by name.                             |
+| `AGENT_STOP`     | `as`     | Stop the currently running agent.                 |
+| `AGENT_CONTINUE` | `ac`     | Continue the agent's operation without new input. |
+| `AGENT_STATUS`   | `astat`  | Show the status of the current agent.             |
+| `exit`           |          | Exit from agent interfacto back to chat.          |
+
+**Example:**
+
+```bash
+ara> a interview_agent
+```
+
+**Important:** The agent functionality requires the `ara-agents` package to be installed separately. If you do not have `ara-agents` installed, please contact the Talsen Team for assistance.
+
 ---
 
 ## Artefact Structure

{ara_cli-0.1.10.5 → ara_cli-0.1.11.1}/README.md

@@ -103,6 +103,35 @@ ara autofix
 
 See `ara -h` for the complete list of commands and usage examples.
 
+---
+## Agent Commands
+
+`ara-cli` includes powerful agent-based capabilities that can be accessed through the interactive chat. These agents can perform complex, multi-step tasks, such as conducting interviews or automating coding workflows.
+
+To use the agent commands, first start an interactive chat session:
+
+```bash
+ara prompt chat <artefact_classifier> <artefact_name>
+```
+
+Once inside the chat, you can use the following commands to manage agents:
+
+| Command          | Shortcut | Description                                       |
+| ---------------- | -------- | ------------------------------------------------- |
+| `AGENT_RUN`      | `a`      | Run an agent by name.                             |
+| `AGENT_STOP`     | `as`     | Stop the currently running agent.                 |
+| `AGENT_CONTINUE` | `ac`     | Continue the agent's operation without new input. |
+| `AGENT_STATUS`   | `astat`  | Show the status of the current agent.             |
+| `exit`           |          | Exit from agent interfacto back to chat.          |
+
+**Example:**
+
+```bash
+ara> a interview_agent
+```
+
+**Important:** The agent functionality requires the `ara-agents` package to be installed separately. If you do not have `ara-agents` installed, please contact the Talsen Team for assistance.
+
 ---
 
 ## Artefact Structure

{ara_cli-0.1.10.5 → ara_cli-0.1.11.1}/ara_cli/__init__.py

@@ -4,7 +4,6 @@ from .error_handler import ErrorHandler
 
 whitelisted_commands = ["RERUN", "SEND", "EXTRACT", "LOAD_IMAGE", "CHOOSE_MODEL", "CHOOSE_EXTRACTION_MODEL", "CURRENT_MODEL", "CURRENT_EXTRACTION_MODEL", "LIST_MODELS"]
 
-
 error_handler = ErrorHandler()
 
 

{ara_cli-0.1.10.5 → ara_cli-0.1.11.1}/ara_cli/__main__.py

@@ -1,9 +1,7 @@
 import typer
-import sys
 import os
 from typing import Optional
 from os import getenv
-from ara_cli.error_handler import AraError
 from ara_cli.version import __version__
 from ara_cli import error_handler
 from ara_cli.ara_subcommands.create import register as register_create_cli
@@ -15,6 +13,7 @@ from ara_cli.ara_subcommands.prompt import register as register_prompt_cli
 from ara_cli.ara_subcommands.chat import register as register_chat_cli
 from ara_cli.ara_subcommands.template import register as register_template_cli
 from ara_cli.ara_subcommands.fetch_templates import register as register_fetch_templates_cli
+from ara_cli.ara_subcommands.fetch_scripts import register as register_fetch_scripts_cli
 from ara_cli.ara_subcommands.read import register as register_read_cli
 from ara_cli.ara_subcommands.reconnect import register as register_reconnect_cli
 from ara_cli.ara_subcommands.read_status import register as register_read_status_cli
@@ -27,6 +26,8 @@ from ara_cli.ara_subcommands.autofix import register as register_autofix_cli
 from ara_cli.ara_subcommands.extract import register as register_extract_cli
 from ara_cli.ara_subcommands.load import register as register_load_cli
 
+from ara_cli.directory_navigator import DirectoryNavigator
+
 
 def version_callback(value: bool):
     if value:
@@ -45,58 +46,32 @@ def configure_debug_mode(debug: bool, env_debug_mode: bool):
         error_handler.debug_mode = True
 
 
-def find_ara_directory_root():
-    """Find the root ara directory by traversing up the directory tree."""
-    current_dir = os.getcwd()
-    
-    # Check if we're already inside an ara directory structure
-    path_parts = current_dir.split(os.sep)
-    
-    # Look for 'ara' in the path parts
-    if 'ara' in path_parts:
-        ara_index = path_parts.index('ara')
-        # Reconstruct path up to and including 'ara'
-        ara_root_parts = path_parts[:ara_index + 1]
-        potential_ara_root = os.sep.join(ara_root_parts)
-        if os.path.exists(potential_ara_root) and os.path.isdir(potential_ara_root):
-            return potential_ara_root
-    
-    # If not inside ara directory, check current directory and parents
-    check_dir = current_dir
-    while check_dir != os.path.dirname(check_dir):  # Stop at filesystem root
-        ara_path = os.path.join(check_dir, 'ara')
-        if os.path.exists(ara_path) and os.path.isdir(ara_path):
-            return ara_path
-        check_dir = os.path.dirname(check_dir)
-    
-    return None
-
-
 def check_ara_directory_exists():
     """Check if ara directory exists or if we're inside ara directory tree."""
-    return find_ara_directory_root() is not None
+    return DirectoryNavigator.find_ara_directory_root() is not None
 
 
 def prompt_create_ara_directory():
     """Prompt user to create ara directory and create it if confirmed."""
     # Print the prompt message
-    print("No 'ara' directory found. Create one in the current directory? (Y/n)", end=" ", flush=True)
-    
+    print("No 'ara' directory found. Create one in the current directory? (Y/n)",
+          end=" ", flush=True)
+
     # Read user input
     try:
         response = input().strip()
     except (EOFError, KeyboardInterrupt):
         typer.echo("\nOperation cancelled.")
         raise typer.Exit(1)
-    
+
     if response.lower() in ('y', 'yes', ''):
         current_dir = os.getcwd()
         ara_path = os.path.join(current_dir, 'ara')
-        
+
         # Create ara directory structure
         subdirectories = [
             'businessgoals',
-            'capabilities', 
+            'capabilities',
             'epics',
             'examples',
             'features',
@@ -105,35 +80,35 @@ def prompt_create_ara_directory():
             'userstories',
             'vision'
         ]
-        
+
         try:
             # Create main ara directory
             os.makedirs(ara_path, exist_ok=True)
-            
+
             # Create subdirectories for artefact types
             for subdir in subdirectories:
                 os.makedirs(os.path.join(ara_path, subdir), exist_ok=True)
-            
+
             # Create .araconfig directory
             araconfig_path = os.path.join(ara_path, '.araconfig')
             os.makedirs(araconfig_path, exist_ok=True)
-            
+
             # Create default ara_config.json using ConfigManager
             from ara_cli.ara_config import ConfigManager, ARAconfig
             config_file_path = os.path.join(araconfig_path, 'ara_config.json')
-            
+
             # Reset ConfigManager to ensure clean state
             ConfigManager.reset()
-            
+
             # Create default config and save it
             default_config = ARAconfig()
             from ara_cli.ara_config import save_data
             save_data(config_file_path, default_config)
-            
+
             typer.echo(f"Created ara directory structure at {ara_path}")
             typer.echo(f"Created default configuration at {config_file_path}")
             return True
-            
+
         except OSError as e:
             typer.echo(f"Error creating ara directory: {e}", err=True)
             raise typer.Exit(1)
@@ -232,15 +207,15 @@ ara chat examples:
         if ctx.invoked_subcommand is None:
             ctx.get_help()
             ctx.exit()
-        
+
         # Check for ara directory before executing any command
         # Skip check for commands that don't require ara directory
         commands_requiring_ara = {
-            'create', 'delete', 'rename', 'list', 'list-tags', 'prompt', 
-            'read', 'reconnect', 'read-status', 'read-user', 'set-status', 
-            'set-user', 'classifier-directory', 'scan', 'autofix'
+            'create', 'delete', 'rename', 'list', 'list-tags', 'prompt',
+            'read', 'reconnect', 'read-status', 'read-user', 'set-status',
+            'set-user', 'scan', 'autofix'
         }
-        
+
         if ctx.invoked_subcommand in commands_requiring_ara:
             requires_ara_directory()
 
@@ -254,6 +229,7 @@ ara chat examples:
     register_chat_cli(app)
     register_template_cli(app)
     register_fetch_templates_cli(app)
+    register_fetch_scripts_cli(app)
     register_read_cli(app)
     register_reconnect_cli(app)
     register_read_status_cli(app)
@@ -281,4 +257,4 @@ def cli():
 
 
 if __name__ == "__main__":
-    cli()
+    cli()

{ara_cli-0.1.10.5 → ara_cli-0.1.11.1}/ara_cli/ara_config.py

@@ -29,6 +29,8 @@ class ARAconfig(BaseModel):
     doc_dir: str = "./docs"
     local_prompt_templates_dir: str = "./ara/.araconfig"
     custom_prompt_templates_subdir: Optional[str] = "custom-prompt-modules"
+    local_scripts_dir: str = "./ara/.araconfig"
+    custom_scripts_subdir: Optional[str] = "custom-scripts"
     local_ara_templates_dir: str = "./ara/.araconfig/templates/"
     ara_prompt_given_list_includes: List[str] = Field(
         default_factory=lambda: [
@@ -113,6 +115,7 @@ class ARAconfig(BaseModel):
             "ext_code_dirs": [{"source_dir": "./src"}, {"source_dir": "./tests"}],
             "local_ara_templates_dir": "./ara/.araconfig/templates/",
             "local_prompt_templates_dir": "./ara/.araconfig",
+            "local_scripts_dir": "./ara/.araconfig",
             "glossary_dir": "./glossary",
         }
 

ara_cli-0.1.11.1/ara_cli/ara_subcommands/fetch_scripts.py

@@ -0,0 +1,8 @@
+import typer
+from ara_cli.commands.fetch_scripts_command import FetchScriptsCommand
+
+def register(app: typer.Typer):
+    @app.command(name="fetch-scripts", help="Fetch global scripts into your config directory.")
+    def fetch_scripts():
+        command = FetchScriptsCommand()
+        command.execute()