mcli-framework 7.11.0__tar.gz → 7.11.1__tar.gz

{mcli_framework-7.11.0 → mcli_framework-7.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcli-framework
-Version: 7.11.0
+Version: 7.11.1
 Summary: Portable workflow framework - transform any script into a versioned, schedulable command. Store in ~/.mcli/commands/, version with lockfile, run as daemon or cron job.
 Author-email: Luis Fernandez de la Vara <luis@lefv.io>
 Maintainer-email: Luis Fernandez de la Vara <luis@lefv.io>
@@ -216,6 +216,24 @@ pip install mcli-framework
 uv pip install mcli-framework
 ```
 
+### Initialize Workflows Directory
+
+```bash
+# Initialize workflows in current git repository
+mcli workflow init
+
+# Or initialize global workflows
+mcli workflow init --global
+
+# Initialize with git repository for workflows
+mcli workflow init --git
+```
+
+This creates a `.mcli/workflows/` directory (local to your repo) or `~/.mcli/workflows/` (global) with:
+- README.md with usage instructions
+- commands.lock.json for version tracking
+- .gitignore for backup files
+
 ### Create Your First Workflow
 
 #### Method 1: From a Python Script

{mcli_framework-7.11.0 → mcli_framework-7.11.1}/README.md

@@ -56,6 +56,24 @@ pip install mcli-framework
 uv pip install mcli-framework
 ```
 
+### Initialize Workflows Directory
+
+```bash
+# Initialize workflows in current git repository
+mcli workflow init
+
+# Or initialize global workflows
+mcli workflow init --global
+
+# Initialize with git repository for workflows
+mcli workflow init --git
+```
+
+This creates a `.mcli/workflows/` directory (local to your repo) or `~/.mcli/workflows/` (global) with:
+- README.md with usage instructions
+- commands.lock.json for version tracking
+- .gitignore for backup files
+
 ### Create Your First Workflow
 
 #### Method 1: From a Python Script

{mcli_framework-7.11.0 → mcli_framework-7.11.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcli-framework"
-version = "7.11.0"
+version = "7.11.1"
 description = "Portable workflow framework - transform any script into a versioned, schedulable command. Store in ~/.mcli/commands/, version with lockfile, run as daemon or cron job."
 readme = "README.md"
 requires-python = ">=3.9"

mcli_framework-7.11.1/src/mcli/__init__.py

@@ -0,0 +1,160 @@
+# logger.info("I am in mcli.__init__.py")
+import sys
+
+try:
+    from mcli.app import main
+
+    # from mcli.public import *
+    # from mcli.private import *
+    # Import the complete Click superset decorators
+    from mcli.lib.api.mcli_decorators import BOOL  # mcli.BOOL - Click BOOL type
+    from mcli.lib.api.mcli_decorators import FLOAT  # mcli.FLOAT - Click FLOAT type
+    from mcli.lib.api.mcli_decorators import INT  # mcli.INT - Click INT type
+    from mcli.lib.api.mcli_decorators import STRING  # mcli.STRING - Click STRING type
+    from mcli.lib.api.mcli_decorators import UNPROCESSED  # mcli.UNPROCESSED - Click UNPROCESSED
+    from mcli.lib.api.mcli_decorators import UUID  # mcli.UUID - Click UUID type
+    from mcli.lib.api.mcli_decorators import Abort  # mcli.Abort - Click Abort
+    from mcli.lib.api.mcli_decorators import BadParameter  # mcli.BadParameter - Click BadParameter
+    from mcli.lib.api.mcli_decorators import Choice  # mcli.Choice - Click Choice type
+    from mcli.lib.api.mcli_decorators import File  # mcli.File - Click File type
+    from mcli.lib.api.mcli_decorators import FloatRange  # mcli.FloatRange - Click FloatRange type
+    from mcli.lib.api.mcli_decorators import IntRange  # mcli.IntRange - Click IntRange type
+    from mcli.lib.api.mcli_decorators import ParamType  # mcli.ParamType - Click ParamType
+    from mcli.lib.api.mcli_decorators import Path  # mcli.Path - Click Path type
+    from mcli.lib.api.mcli_decorators import UsageError  # mcli.UsageError - Click UsageError
+    from mcli.lib.api.mcli_decorators import api  # @mcli.api - Legacy API decorator
+    from mcli.lib.api.mcli_decorators import (
+        api_command,  # @mcli.api_command - Convenience for API endpoints
+    )
+    from mcli.lib.api.mcli_decorators import argument  # @mcli.argument - Click argument decorator
+    from mcli.lib.api.mcli_decorators import (
+        background,  # @mcli.background - Legacy background decorator
+    )
+    from mcli.lib.api.mcli_decorators import (
+        background_command,  # @mcli.background_command - Convenience for background
+    )
+    from mcli.lib.api.mcli_decorators import clear  # mcli.clear - Click clear
+    from mcli.lib.api.mcli_decorators import (
+        cli_with_api,  # @mcli.cli_with_api - Legacy combined decorator
+    )
+    from mcli.lib.api.mcli_decorators import (
+        command,  # @mcli.command - Complete Click command with API/background
+    )
+    from mcli.lib.api.mcli_decorators import confirm  # mcli.confirm - Click confirmation
+    from mcli.lib.api.mcli_decorators import echo  # mcli.echo - Click echo function
+    from mcli.lib.api.mcli_decorators import edit  # mcli.edit - Click editor
+    from mcli.lib.api.mcli_decorators import (
+        format_filename,  # mcli.format_filename - Click filename
+    )
+    from mcli.lib.api.mcli_decorators import get_app  # mcli.get_app - Click app
+    from mcli.lib.api.mcli_decorators import get_app_dir  # mcli.get_app_dir - Click app directory
+    from mcli.lib.api.mcli_decorators import (
+        get_binary_stream,  # mcli.get_binary_stream - Click binary stream
+    )
+    from mcli.lib.api.mcli_decorators import (
+        get_current_context,  # mcli.get_current_context - Click context
+    )
+    from mcli.lib.api.mcli_decorators import (
+        get_network_credentials,  # mcli.get_network_credentials - Click network
+    )
+    from mcli.lib.api.mcli_decorators import get_os_args  # mcli.get_os_args - Click OS args
+    from mcli.lib.api.mcli_decorators import (
+        get_terminal_size,  # mcli.get_terminal_size - Click terminal size
+    )
+    from mcli.lib.api.mcli_decorators import (
+        get_text_stream,  # mcli.get_text_stream - Click text stream
+    )
+    from mcli.lib.api.mcli_decorators import getchar  # mcli.getchar - Click character input
+    from mcli.lib.api.mcli_decorators import (
+        group,  # @mcli.group - Complete Click group with API support
+    )
+    from mcli.lib.api.mcli_decorators import launch  # mcli.launch - Click launch
+    from mcli.lib.api.mcli_decorators import open_file  # mcli.open_file - Click file operations
+    from mcli.lib.api.mcli_decorators import option  # @mcli.option - Click option decorator
+    from mcli.lib.api.mcli_decorators import pause  # mcli.pause - Click pause
+    from mcli.lib.api.mcli_decorators import progressbar  # mcli.progressbar - Click progress bar
+    from mcli.lib.api.mcli_decorators import prompt  # mcli.prompt - Click prompt
+    from mcli.lib.api.mcli_decorators import secho  # mcli.secho - Click styled echo
+    from mcli.lib.api.mcli_decorators import style  # mcli.style - Click styling
+    from mcli.lib.api.mcli_decorators import unstyle  # mcli.unstyle - Click unstyle
+    from mcli.lib.api.mcli_decorators import (  # Core decorators (complete Click superset); Click re-exports (complete subsume); Click types (complete subsume); Convenience decorators; Legacy decorators (for backward compatibility); Server management; Configuration; Convenience functions
+        disable_api_server,
+        enable_api_server,
+        get_api_config,
+        health_check,
+        is_background_available,
+        is_server_running,
+        start_server,
+        status_check,
+        stop_server,
+    )
+
+    # Make everything available at the top level (complete Click subsume)
+    __all__ = [
+        "main",
+        # Core decorators (complete Click superset)
+        "command",
+        "group",
+        # Click re-exports (complete subsume)
+        "option",
+        "argument",
+        "echo",
+        "get_current_context",
+        "get_app",
+        "launch",
+        "open_file",
+        "get_os_args",
+        "get_binary_stream",
+        "get_text_stream",
+        "format_filename",
+        "getchar",
+        "pause",
+        "clear",
+        "style",
+        "unstyle",
+        "secho",
+        "edit",
+        "confirm",
+        "prompt",
+        "progressbar",
+        "get_terminal_size",
+        "get_app_dir",
+        "get_network_credentials",
+        # Click types (complete subsume)
+        "Path",
+        "Choice",
+        "IntRange",
+        "FloatRange",
+        "UNPROCESSED",
+        "STRING",
+        "INT",
+        "FLOAT",
+        "BOOL",
+        "UUID",
+        "File",
+        "ParamType",
+        "BadParameter",
+        "UsageError",
+        "Abort",
+        # Convenience decorators
+        "api_command",
+        "background_command",
+        # Legacy decorators (for backward compatibility)
+        "api",
+        "background",
+        "cli_with_api",
+        # Server management
+        "start_server",
+        "stop_server",
+        "is_server_running",
+        "is_background_available",
+        "get_api_config",
+        "enable_api_server",
+        "disable_api_server",
+        "health_check",
+        "status_check",
+    ]
+
+except ImportError:
+    # from .app import main
+    sys.exit(1)

mcli_framework-7.11.1/src/mcli/__main__.py

@@ -0,0 +1,14 @@
+# logger.info("I am in mcli.__init__.py")
+
+try:
+    from mcli.app.main import main as main_func
+
+    # from mcli.public import *
+    # from mcli.private import *
+except ImportError:
+    from .app.main import main as main_func
+
+__all__ = ["main_func"]
+
+if __name__ == "__main__":
+    main_func()

mcli_framework-7.11.1/src/mcli/app/__init__.py

@@ -0,0 +1,23 @@
+# src/mcli/app/__init__.py
+import importlib
+from pathlib import Path
+
+from mcli.lib.logger.logger import get_logger
+
+logger = get_logger(__name__)
+
+logger.info("Initializing mcli.app package")
+
+# Import main function
+try:
+    from .main import main
+
+    logger.info("Successfully imported main from .main")
+except ImportError as e:
+    logger.error(f"Failed to import main: {e}")
+    import traceback
+
+    logger.error(f"Traceback: {traceback.format_exc()}")
+    raise
+
+__all__ = ["main"]

{mcli_framework-7.11.0 → mcli_framework-7.11.1}/src/mcli/app/commands_cmd.py

@@ -182,6 +182,261 @@ def workflow():
 commands = workflow
 
 
+@workflow.command("init")
+@click.option(
+    "--global", "-g", "is_global", is_flag=True, help="Initialize global workflows directory instead of local"
+)
+@click.option(
+    "--git", is_flag=True, help="Initialize git repository in workflows directory"
+)
+@click.option(
+    "--force", "-f", is_flag=True, help="Force initialization even if directory exists"
+)
+def init_workflows(is_global, git, force):
+    """
+    Initialize workflows directory structure.
+
+    Creates the necessary directories and configuration files for managing
+    custom workflows. By default, creates a local .mcli/workflows/ directory
+    if in a git repository, otherwise uses ~/.mcli/workflows/.
+
+    Examples:
+        mcli workflow init              # Initialize local workflows (if in git repo)
+        mcli workflow init --global     # Initialize global workflows
+        mcli workflow init --git        # Also initialize git repository
+    """
+    from mcli.lib.paths import (
+        get_custom_commands_dir,
+        get_lockfile_path,
+        get_git_root,
+        is_git_repository,
+    )
+
+    # Determine if we're in a git repository
+    in_git_repo = is_git_repository() and not is_global
+    git_root = get_git_root() if in_git_repo else None
+
+    # Get the workflows directory
+    workflows_dir = get_custom_commands_dir(global_mode=is_global)
+    lockfile_path = get_lockfile_path(global_mode=is_global)
+
+    # Check if already initialized
+    if workflows_dir.exists() and not force:
+        if lockfile_path.exists():
+            console.print(f"[yellow]Workflows directory already initialized at:[/yellow] {workflows_dir}")
+            console.print(f"[dim]Use --force to reinitialize[/dim]")
+
+            should_continue = Prompt.ask(
+                "Continue anyway?", choices=["y", "n"], default="n"
+            )
+            if should_continue.lower() != "y":
+                return 0
+
+    # Create workflows directory
+    workflows_dir.mkdir(parents=True, exist_ok=True)
+    console.print(f"[green]✓[/green] Created workflows directory: {workflows_dir}")
+
+    # Create README.md
+    readme_path = workflows_dir / "README.md"
+    if not readme_path.exists() or force:
+        scope = "local" if in_git_repo else "global"
+        scope_desc = f"for repository: {git_root.name}" if in_git_repo else "globally"
+
+        readme_content = f"""# MCLI Custom Workflows
+
+This directory contains custom workflow commands {scope_desc}.
+
+## Quick Start
+
+### Create a New Workflow
+
+```bash
+# Python workflow
+mcli workflow add my-workflow
+
+# Shell workflow
+mcli workflow add my-script --language shell
+```
+
+### List Workflows
+
+```bash
+mcli workflow list --custom-only
+```
+
+### Execute a Workflow
+
+```bash
+mcli workflows my-workflow
+```
+
+### Edit a Workflow
+
+```bash
+mcli workflow edit my-workflow
+```
+
+### Export/Import Workflows
+
+```bash
+# Export all workflows
+mcli workflow export workflows-backup.json
+
+# Import workflows
+mcli workflow import workflows-backup.json
+```
+
+## Directory Structure
+
+```
+{workflows_dir.name}/
+├── README.md              # This file
+├── commands.lock.json     # Lockfile for workflow state
+└── *.json                 # Individual workflow definitions
+```
+
+## Workflow Format
+
+Workflows are stored as JSON files with the following structure:
+
+```json
+{{
+  "name": "workflow-name",
+  "description": "Workflow description",
+  "code": "Python or shell code",
+  "language": "python",
+  "group": "workflow",
+  "version": "1.0",
+  "created_at": "2025-10-30T...",
+  "updated_at": "2025-10-30T..."
+}}
+```
+
+## Scope
+
+- **Scope**: {'Local (repository-specific)' if in_git_repo else 'Global (user-wide)'}
+- **Location**: `{workflows_dir}`
+{f"- **Git Repository**: `{git_root}`" if git_root else ""}
+
+## Documentation
+
+- [MCLI Documentation](https://github.com/gwicho38/mcli)
+- [Workflow Guide](https://github.com/gwicho38/mcli/blob/main/docs/features/LOCAL_VS_GLOBAL_COMMANDS.md)
+
+---
+
+*Initialized: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}*
+"""
+
+        readme_path.write_text(readme_content)
+        console.print(f"[green]✓[/green] Created README: {readme_path.name}")
+
+    # Initialize lockfile
+    if not lockfile_path.exists() or force:
+        lockfile_data = {
+            "version": "1.0",
+            "initialized_at": datetime.now().isoformat(),
+            "scope": "local" if in_git_repo else "global",
+            "commands": {}
+        }
+
+        with open(lockfile_path, "w") as f:
+            json.dump(lockfile_data, f, indent=2)
+
+        console.print(f"[green]✓[/green] Initialized lockfile: {lockfile_path.name}")
+
+    # Create .gitignore if in workflows directory
+    gitignore_path = workflows_dir / ".gitignore"
+    if not gitignore_path.exists() or force:
+        gitignore_content = """# Backup files
+*.backup
+*.bak
+
+# Temporary files
+*.tmp
+*.temp
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Editor files
+*.swp
+*.swo
+*~
+.vscode/
+.idea/
+"""
+        gitignore_path.write_text(gitignore_content)
+        console.print(f"[green]✓[/green] Created .gitignore")
+
+    # Initialize git if requested
+    if git and not (workflows_dir / ".git").exists():
+        try:
+            subprocess.run(
+                ["git", "init"],
+                cwd=workflows_dir,
+                check=True,
+                capture_output=True
+            )
+            console.print(f"[green]✓[/green] Initialized git repository in workflows directory")
+
+            # Create initial commit
+            subprocess.run(
+                ["git", "add", "."],
+                cwd=workflows_dir,
+                check=True,
+                capture_output=True
+            )
+            subprocess.run(
+                ["git", "commit", "-m", "Initial commit: Initialize workflows directory"],
+                cwd=workflows_dir,
+                check=True,
+                capture_output=True
+            )
+            console.print(f"[green]✓[/green] Created initial commit")
+
+        except subprocess.CalledProcessError as e:
+            console.print(f"[yellow]⚠[/yellow] Git initialization failed: {e}")
+        except FileNotFoundError:
+            console.print(f"[yellow]⚠[/yellow] Git not found. Skipping git initialization.")
+
+    # Summary
+    console.print()
+    console.print("[bold green]Workflows directory initialized successfully![/bold green]")
+    console.print()
+
+    # Display summary table
+    table = Table(title="Initialization Summary", show_header=False)
+    table.add_column("Property", style="cyan")
+    table.add_column("Value", style="green")
+
+    table.add_row("Scope", "Local (repository-specific)" if in_git_repo else "Global (user-wide)")
+    table.add_row("Location", str(workflows_dir))
+    if git_root:
+        table.add_row("Git Repository", str(git_root))
+    table.add_row("Lockfile", str(lockfile_path))
+    table.add_row("Git Initialized", "Yes" if git and (workflows_dir / ".git").exists() else "No")
+
+    console.print(table)
+    console.print()
+
+    # Next steps
+    console.print("[bold]Next Steps:[/bold]")
+    console.print("  1. Create a workflow:  [cyan]mcli workflow add my-workflow[/cyan]")
+    console.print("  2. List workflows:     [cyan]mcli workflow list --custom-only[/cyan]")
+    console.print("  3. Execute workflow:   [cyan]mcli workflows my-workflow[/cyan]")
+    console.print("  4. View README:        [cyan]cat {}/README.md[/cyan]".format(workflows_dir))
+    console.print()
+
+    if in_git_repo:
+        console.print(f"[dim]Tip: Workflows are local to this repository. Use --global for user-wide workflows.[/dim]")
+    else:
+        console.print(f"[dim]Tip: Use workflows in any git repository, or create local ones with 'mcli workflow init' inside repos.[/dim]")
+
+    return 0
+
+
 @workflow.command("list")
 @click.option("--include-groups", is_flag=True, help="Include command groups in listing")
 @click.option("--daemon-only", is_flag=True, help="Show only daemon database commands")

mcli_framework-7.11.1/src/mcli/app/video/__init__.py

@@ -0,0 +1,5 @@
+"""
+Video processing commands for mcli.
+"""
+
+from .video import *

mcli_framework-7.11.1/src/mcli/chat/__init__.py

@@ -0,0 +1,34 @@
+"""
+MCLI Chat System
+Real-time system control and interaction capabilities for MCLI chat
+"""
+
+from .system_controller import (
+    SystemController,
+    control_app,
+    execute_system_command,
+    open_file_or_url,
+    open_textedit_and_write,
+    system_controller,
+    take_screenshot,
+)
+from .system_integration import (
+    ChatSystemIntegration,
+    chat_system_integration,
+    get_system_capabilities,
+    handle_system_request,
+)
+
+__all__ = [
+    "SystemController",
+    "system_controller",
+    "ChatSystemIntegration",
+    "chat_system_integration",
+    "handle_system_request",
+    "get_system_capabilities",
+    "open_textedit_and_write",
+    "control_app",
+    "execute_system_command",
+    "take_screenshot",
+    "open_file_or_url",
+]

mcli_framework-7.11.1/src/mcli/lib/auth/__init__.py

@@ -0,0 +1 @@
+from .auth import *

mcli_framework-7.11.1/src/mcli/lib/config/__init__.py

@@ -0,0 +1 @@
+from .config import *

mcli_framework-7.11.1/src/mcli/lib/erd/__init__.py

@@ -0,0 +1,25 @@
+"""
+Entity Relationship Diagram (ERD) package.
+
+This package provides utilities for generating Entity Relationship Diagrams from MCLI type metadata.
+"""
+
+# Import and export all public functions from erd.py
+from .erd import (
+    analyze_graph_for_hierarchical_exports,
+    create_merged_erd,
+    do_erd,
+    find_top_nodes_in_graph,
+    generate_erd_for_top_nodes,
+    generate_merged_erd_for_types,
+)
+
+# Define __all__ to control exports
+__all__ = [
+    "do_erd",
+    "create_merged_erd",
+    "generate_merged_erd_for_types",
+    "find_top_nodes_in_graph",
+    "generate_erd_for_top_nodes",
+    "analyze_graph_for_hierarchical_exports",
+]

mcli_framework-7.11.1/src/mcli/lib/fs/__init__.py

@@ -0,0 +1 @@
+from .fs import *

mcli_framework-7.11.1/src/mcli/lib/logger/__init__.py

@@ -0,0 +1,3 @@
+from .logger import get_logger
+
+__all__ = ["get_logger"]

{mcli_framework-7.11.0 → mcli_framework-7.11.1}/src/mcli/lib/paths.py

@@ -158,9 +158,13 @@ def get_local_commands_dir() -> Optional[Path]:
         if workflows_dir.exists():
             return workflows_dir
 
-        # Fall back to old commands directory for migration support
+        # Check if old commands directory exists (for migration support)
         commands_dir = local_mcli / "commands"
-        return commands_dir
+        if commands_dir.exists():
+            return commands_dir
+
+        # If neither exists, return workflows path (for new installations)
+        return workflows_dir
     return None
 
 

mcli_framework-7.11.1/src/mcli/lib/performance/__init__.py

@@ -0,0 +1,17 @@
+"""
+Performance optimization utilities for mcli
+"""
+
+from .uvloop_config import (
+    configure_event_loop_for_performance,
+    get_event_loop_info,
+    install_uvloop,
+    should_use_uvloop,
+)
+
+__all__ = [
+    "install_uvloop",
+    "should_use_uvloop",
+    "get_event_loop_info",
+    "configure_event_loop_for_performance",
+]

mcli_framework-7.11.1/src/mcli/lib/pickles/__init__.py

@@ -0,0 +1 @@
+from .pickles import ObjectCache

mcli_framework-7.11.1/src/mcli/lib/secrets/__init__.py

@@ -0,0 +1,10 @@
+"""
+Secrets management module for MCLI.
+
+Provides secure storage and retrieval of secrets with git-based synchronization.
+"""
+
+from .manager import SecretsManager
+from .store import SecretsStore
+
+__all__ = ["SecretsManager", "SecretsStore"]

mcli_framework-7.11.1/src/mcli/lib/toml/__init__.py

@@ -0,0 +1 @@
+from .toml import read_from_toml