up-cli 0.1.1__py3-none-any.whl → 0.5.0__py3-none-any.whl

up/__init__.py

@@ -1,3 +1,3 @@
 """up - AI-powered project scaffolding CLI."""
 
-__version__ = "0.1.0"
+__version__ = "0.4.0"

up/ai_cli.py

@@ -0,0 +1,229 @@
+"""AI CLI utilities - shared functions for Claude and Cursor agent CLIs."""
+
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Optional
+
+from rich.console import Console
+
+console = Console()
+
+
+# =============================================================================
+# Exceptions
+# =============================================================================
+
+class AICliError(Exception):
+    """Base exception for AI CLI operations."""
+    pass
+
+
+class AICliNotFoundError(AICliError):
+    """No AI CLI is installed or available."""
+    pass
+
+
+class AICliTimeoutError(AICliError):
+    """AI CLI command timed out."""
+    
+    def __init__(self, message: str, timeout: int):
+        super().__init__(message)
+        self.timeout = timeout
+
+
+class AICliExecutionError(AICliError):
+    """AI CLI command failed to execute."""
+    
+    def __init__(self, message: str, returncode: int, stderr: str = ""):
+        super().__init__(message)
+        self.returncode = returncode
+        self.stderr = stderr
+
+
+# =============================================================================
+# CLI Detection
+# =============================================================================
+
+
+def check_ai_cli() -> tuple[str, bool]:
+    """Check which AI CLI is available.
+    
+    Checks for Claude CLI first, then Cursor agent CLI.
+    
+    Returns:
+        (cli_name, available) - e.g., ("claude", True) or ("agent", True)
+    """
+    # Check for Claude CLI first
+    if shutil.which("claude"):
+        return "claude", True
+    
+    # Check for Cursor Agent CLI
+    # See: https://cursor.com/docs/cli/overview
+    if shutil.which("agent"):
+        return "agent", True
+    
+    return "", False
+
+
+def run_ai_prompt(
+    workspace: Path,
+    prompt: str,
+    cli_name: str,
+    timeout: int = 180,
+    silent: bool = False
+) -> Optional[str]:
+    """Run a prompt through AI CLI and return the response.
+    
+    Supports both Claude CLI and Cursor agent CLI.
+    
+    Args:
+        workspace: Working directory
+        prompt: The prompt to send
+        cli_name: "claude" or "agent"
+        timeout: Timeout in seconds (default 3 minutes)
+        silent: If True, don't print warning messages on failure
+    
+    Returns:
+        Response text or None if failed
+    """
+    # Verify CLI is available
+    if not shutil.which(cli_name):
+        if not silent:
+            console.print(f"[yellow]AI CLI '{cli_name}' not found, using basic analysis[/]")
+        return None
+    
+    try:
+        if cli_name == "claude":
+            # Claude CLI: claude -p "prompt"
+            cmd = ["claude", "-p", prompt]
+        else:
+            # Cursor agent CLI: agent -p "prompt" --output-format text
+            # See: https://cursor.com/docs/cli/overview
+            cmd = ["agent", "-p", prompt, "--output-format", "text"]
+        
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=timeout,
+            cwd=workspace
+        )
+        
+        if result.returncode == 0 and result.stdout.strip():
+            return result.stdout.strip()
+        
+        if not silent and result.stderr:
+            console.print(f"[yellow]AI returned error: {result.stderr[:200]}[/]")
+        return None
+    
+    except subprocess.TimeoutExpired:
+        if not silent:
+            console.print(f"[yellow]AI analysis timed out ({timeout}s), using basic analysis[/]")
+        return None
+    except FileNotFoundError:
+        if not silent:
+            console.print(f"[yellow]AI CLI '{cli_name}' not found, using basic analysis[/]")
+        return None
+    except Exception as e:
+        if not silent:
+            console.print(f"[yellow]AI error: {e}, using basic analysis[/]")
+        return None
+
+
+def run_ai_task(
+    workspace: Path,
+    prompt: str,
+    cli_name: str,
+    timeout: int = 600,
+    max_tokens: int = 0,
+    raise_on_error: bool = False
+) -> tuple[bool, str]:
+    """Run an AI task (like implementing code) and return success status.
+    
+    Args:
+        workspace: Working directory
+        prompt: The task prompt
+        cli_name: "claude" or "agent"
+        timeout: Timeout in seconds (default 10 minutes)
+        max_tokens: Max output tokens (0 = no limit/use CLI default)
+        raise_on_error: If True, raise exceptions instead of returning (False, error)
+    
+    Returns:
+        (success, output) tuple
+        
+    Raises:
+        AICliNotFoundError: If raise_on_error and CLI not found
+        AICliTimeoutError: If raise_on_error and command times out
+        AICliExecutionError: If raise_on_error and command fails
+    """
+    # Verify CLI is available
+    if not shutil.which(cli_name):
+        error_msg = f"AI CLI '{cli_name}' not found in PATH"
+        if raise_on_error:
+            raise AICliNotFoundError(error_msg)
+        return False, error_msg
+    
+    try:
+        if cli_name == "claude":
+            # Claude CLI: claude -p "prompt" [--max-tokens N]
+            cmd = ["claude", "-p", prompt]
+            # Note: Claude CLI doesn't use --max-tokens, it uses model limits
+            # The output is effectively unlimited for code tasks
+        else:
+            # Cursor agent with text output for automation
+            cmd = ["agent", "-p", prompt, "--output-format", "text"]
+        
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=timeout,
+            cwd=workspace
+        )
+        
+        if result.returncode == 0:
+            return True, result.stdout
+        else:
+            stderr = result.stderr or "Unknown error"
+            if raise_on_error:
+                raise AICliExecutionError(
+                    f"AI task failed with exit code {result.returncode}",
+                    returncode=result.returncode,
+                    stderr=stderr
+                )
+            return False, stderr
+    
+    except subprocess.TimeoutExpired:
+        error_msg = f"AI task timed out ({timeout}s)"
+        if raise_on_error:
+            raise AICliTimeoutError(error_msg, timeout=timeout)
+        return False, error_msg
+    except FileNotFoundError:
+        # This shouldn't happen since we check with shutil.which, but handle anyway
+        error_msg = f"AI CLI '{cli_name}' not found"
+        if raise_on_error:
+            raise AICliNotFoundError(error_msg)
+        return False, error_msg
+    except (AICliError,):
+        # Re-raise our custom exceptions
+        raise
+    except Exception as e:
+        error_msg = f"Unexpected error: {e}"
+        if raise_on_error:
+            raise AICliExecutionError(error_msg, returncode=-1, stderr=str(e))
+        return False, error_msg
+
+
+def get_ai_cli_install_instructions() -> str:
+    """Get installation instructions for AI CLIs."""
+    return """Install one of these AI CLIs:
+
+Claude CLI:
+  npm install -g @anthropic-ai/claude-code
+  
+Cursor Agent CLI:
+  curl https://cursor.com/install -fsS | bash
+  
+See: https://cursor.com/docs/cli/overview
+"""

up/cli.py

@@ -5,23 +5,94 @@ from rich.console import Console
 
 from up.commands.init import init_cmd
 from up.commands.new import new_cmd
+from up.commands.status import status_cmd
+from up.learn import learn_cmd
+from up.commands.summarize import summarize_cmd
+from up.commands.dashboard import dashboard_cmd
+from up.commands.start import start_cmd
+from up.commands.memory import memory_cmd
+from up.commands.sync import sync_cmd, hooks_cmd
+from up.commands.vibe import save_cmd, reset_cmd, diff_cmd
+from up.commands.agent import agent as agent_group
+from up.commands.bisect import bisect_cmd, history_cmd
+from up.commands.provenance import provenance as provenance_group
+from up.commands.review import review_cmd
+from up.commands.branch import branch as branch_group
 
 console = Console()
 
 
 @click.group()
-@click.version_option(version="0.1.0", prog_name="up")
+@click.version_option(version="0.4.0", prog_name="up")
 def main():
-    """up - AI-powered project scaffolding.
+    """up - Verifiable, observable AI-assisted development.
 
-    Create projects with built-in docs, learn, and product-loop systems
-    for Claude Code and Cursor AI.
+    Build tools using vibe coding with safety rails, resulting in
+    stable, high-performance, and modern software engineering.
+    
+    \b
+    Quick Start:
+      up new my-project       Create new project
+      up init                 Initialize in existing project
+      up start                Start the product loop
+      up status               Show system health
+    
+    \b
+    Vibe Coding Safety Rails:
+      up save                 Checkpoint before AI work
+      up reset                Restore to checkpoint
+      up diff                 Review AI changes
+      up start --parallel     Run multiple tasks in parallel
+    
+    \b
+    Project Templates:
+      up new api --template fastapi      FastAPI backend
+      up new app --template nextjs       Next.js frontend
+      up new lib --template python-lib   Python library
+    
+    \b
+    Memory & Learning:
+      up memory search <q>    Semantic search
+      up memory record        Record learnings/decisions
+      up learn                Auto-improve with AI
+    
+    \b
+    System:
+      up hooks                Install git hooks for auto-sync
+      up sync                 Manual sync all systems
+      up dashboard            Live monitoring
     """
     pass
 
 
+# Project commands
 main.add_command(init_cmd, name="init")
 main.add_command(new_cmd, name="new")
+main.add_command(status_cmd, name="status")
+
+# Vibe coding commands
+main.add_command(start_cmd, name="start")
+main.add_command(save_cmd, name="save")
+main.add_command(reset_cmd, name="reset")
+main.add_command(diff_cmd, name="diff")
+main.add_command(agent_group, name="agent")
+
+# Debugging commands
+main.add_command(bisect_cmd, name="bisect")
+main.add_command(history_cmd, name="history")
+main.add_command(provenance_group, name="provenance")
+main.add_command(review_cmd, name="review")
+main.add_command(branch_group, name="branch")
+
+# System commands
+main.add_command(sync_cmd, name="sync")
+main.add_command(hooks_cmd, name="hooks")
+main.add_command(dashboard_cmd, name="dashboard")
+
+# Learning & memory
+main.add_command(learn_cmd, name="learn")
+main.add_command(memory_cmd, name="memory")
+main.add_command(summarize_cmd, name="summarize")
 
 
 if __name__ == "__main__":