scry-run 0.1.1__tar.gz → 0.1.2__tar.gz

{scry_run-0.1.1 → scry_run-0.1.2}/.claude/settings.local.json

@@ -6,7 +6,8 @@
       "Bash(uv run pytest:*)",
       "Bash(uv run python -m pytest:*)",
       "Bash(uv sync:*)",
-      "Bash(uv lock:*)"
+      "Bash(uv lock:*)",
+      "Bash(uv run:*)"
     ]
   }
 }

{scry_run-0.1.1 → scry_run-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scry-run
-Version: 0.1.1
+Version: 0.1.2
 Summary: LLM-powered dynamic code generation via metaclasses. Define classes with docstrings, call any method—code generates automatically, caches persistently, and executes instantly.
 Project-URL: Homepage, https://github.com/Tener/scry-run
 Project-URL: Repository, https://github.com/Tener/scry-run

{scry_run-0.1.1 → scry_run-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "scry-run"
-version = "0.1.1"
+version = "0.1.2"
 description = "LLM-powered dynamic code generation via metaclasses. Define classes with docstrings, call any method—code generates automatically, caches persistently, and executes instantly."
 readme = "README.md"
 license = { text = "MIT" }

{scry_run-0.1.1 → scry_run-0.1.2}/src/scry_run/cli/init.py

@@ -39,7 +39,7 @@ IMPORTANT GUIDELINES:
 - STICK TO WHAT THE USER ASKED FOR - don't add unrelated features
 - Less is more - a focused app is better than a bloated one
 - If the user said "todo list", make a todo list - not a project management suite
-- Total length: 100-200 words (keep it concise!)
+- Total description length: 100-200 words (keep it concise!)
 
 **OPEN WORLD PRINCIPLE**: This app uses scry-run for dynamic code generation. Methods are generated on-demand at runtime, meaning the set of commands is effectively unlimited - but inputs must still be STRUCTURED like a normal CLI:
 - Use standard CLI patterns: commands, subcommands, flags, and positional arguments
@@ -52,10 +52,23 @@ IMPORTANT GUIDELINES:
   - GOOD: `todo add "buy milk"`, `todo list --due=today`, `todo done 3`
   - BAD: `todo what's due today?` (question form)
 
-Return ONLY the expanded description text, no JSON or markdown code blocks.'''
+**APP FLAGS** - Recommend runtime flags for the app:
+- "quiet": true - For TUI/interactive apps (curses, textual, rich.live, pygame, etc.)
+  This shows scry-run status in terminal title bar instead of stderr, preventing display disruption.
+  Only set to true if the app uses a TUI or graphical library.
 
+Return a JSON object with this structure:
+{{
+  "description": "The expanded description text here...",
+  "flags": {{
+    "quiet": false
+  }}
+}}
 
-def expand_description(name: str, description: str) -> str | None:
+Return ONLY the JSON object, no markdown code fences or explanation.'''
+
+
+def expand_description(name: str, description: str) -> dict | None:
     """Use LLM to expand a brief description into a detailed one.
 
     Args:
@@ -63,7 +76,7 @@ def expand_description(name: str, description: str) -> str | None:
         description: User's brief description
 
     Returns:
-        Expanded description, or None if expansion fails
+        Dict with 'description' and 'flags' keys, or None if expansion fails
     """
     try:
         from scry_run.generator import CodeGenerator, ScryRunError
@@ -72,8 +85,32 @@ def expand_description(name: str, description: str) -> str | None:
         prompt = EXPAND_PROMPT.format(name=name, description=description)
 
         # Use generate_freeform for text generation
-        expanded = generator.generate_freeform(prompt)
-        return expanded.strip()
+        response = generator.generate_freeform(prompt)
+        response = response.strip()
+
+        # Parse JSON response
+        # Handle potential markdown code fences
+        if response.startswith("```"):
+            lines = response.split("\n")
+            # Remove first and last lines (code fences)
+            response = "\n".join(lines[1:-1])
+
+        result = json.loads(response)
+
+        # Validate structure
+        if "description" not in result:
+            console.print("[yellow]Warning:[/yellow] LLM response missing 'description' field")
+            return None
+
+        # Ensure flags exists with defaults
+        if "flags" not in result:
+            result["flags"] = {}
+
+        return result
+
+    except json.JSONDecodeError as e:
+        console.print(f"[yellow]Warning:[/yellow] Could not parse LLM response as JSON: {e}")
+        return None
     except ScryRunError as e:
         console.print(f"[yellow]Warning:[/yellow] Could not expand description: {e.message}")
         return None
@@ -279,20 +316,31 @@ def init(
         )
 
     # Auto-expand description using LLM
+    # Track recommended flags from LLM
+    recommended_flags: dict = {}
+
     if auto_expand:
         console.print()
         console.print("[dim]Expanding description with AI...[/dim]")
-        expanded = expand_description(name, description)
+        result = expand_description(name, description)
+
+        if result:
+            expanded_desc = result["description"]
+            recommended_flags = result.get("flags", {})
 
-        if expanded:
             # Show the expanded description
             console.print()
             panel = Panel(
-                expanded,
+                expanded_desc,
                 title="[bold]Expanded Description[/bold]",
                 border_style="blue",
             )
             console.print(panel)
+
+            # Show recommended flags if any are non-default
+            if recommended_flags.get("quiet"):
+                console.print("[dim]Recommended: quiet mode (TUI app)[/dim]")
+
             console.print()
 
             # Let user confirm, edit, or reject
@@ -303,10 +351,10 @@ def init(
                 default="y",
             )
             if choice == "y":
-                description = expanded
+                description = expanded_desc
             elif choice == "e":
                 # Open in editor
-                edited = click.edit(expanded)
+                edited = click.edit(expanded_desc)
                 if edited:
                     description = edited.strip()
                     console.print("[dim]Using edited description.[/dim]")
@@ -314,6 +362,7 @@ def init(
                     console.print("[dim]Editor returned empty, using original.[/dim]")
             else:
                 console.print("[dim]Using original description.[/dim]")
+                recommended_flags = {}  # Reset flags if user rejected expansion
         else:
             console.print("[dim]Using original description.[/dim]")
 
@@ -356,6 +405,15 @@ def init(
     cache_file = app_dir / "cache.json"
     cache_file.write_text(json.dumps({}))
 
+    # Create settings.json with default flags from LLM recommendation
+    settings = {
+        "default_flags": {
+            "quiet": recommended_flags.get("quiet", False),
+        }
+    }
+    settings_file = app_dir / "settings.json"
+    settings_file.write_text(json.dumps(settings, indent=2))
+
     # Create logs directory
     logs_dir = app_dir / "logs"
     logs_dir.mkdir(exist_ok=True)
@@ -365,7 +423,11 @@ def init(
     console.print()
     console.print(f"  [dim]Location:[/dim]  {app_dir}")
     console.print(f"  [dim]Main file:[/dim] {app_file}")
+    console.print(f"  [dim]Settings:[/dim]  {settings_file}")
     console.print()
+    if recommended_flags.get("quiet"):
+        console.print("[dim]Quiet mode enabled (TUI app) - status shown in title bar.[/dim]")
+        console.print()
     console.print("[bold]Useful commands:[/bold]")
     console.print(f"  [cyan]scry-run run {name}[/cyan]         Run your app")
     console.print(f"  [cyan]scry-run info {name}[/cyan]        View app details and cache stats")

{scry_run-0.1.1 → scry_run-0.1.2}/src/scry_run/cli/run.py

@@ -1,5 +1,6 @@
 """Run command for executing scry-run apps."""
 
+import json
 import os
 import subprocess
 
@@ -13,11 +14,23 @@ from scry_run.packages import ensure_scry_run_installed
 console = Console()
 
 
+def load_app_settings(app_dir) -> dict:
+    """Load per-app settings from settings.json."""
+    settings_file = app_dir / "settings.json"
+    if settings_file.exists():
+        try:
+            return json.loads(settings_file.read_text())
+        except (json.JSONDecodeError, OSError):
+            return {}
+    return {}
+
+
 @click.command(context_settings={"ignore_unknown_options": True, "allow_extra_args": True})
+@click.option("--quiet", "-q", is_flag=True, help="Suppress status messages (for TUI apps)")
 @click.argument("app_name")
 @click.argument("args", nargs=-1, type=click.UNPROCESSED)
 @click.pass_context
-def run(ctx, app_name: str, args: tuple[str, ...]) -> None:
+def run(ctx, quiet: bool, app_name: str, args: tuple[str, ...]) -> None:
     """Run an scry-run app.
 
     Loads config from ~/.scry-run/config.toml, converts to env vars,
@@ -28,6 +41,7 @@ def run(ctx, app_name: str, args: tuple[str, ...]) -> None:
         scry-run run todo-app
         scry-run run todo-app add "Buy milk"
         scry-run run todo-app --help
+        scry-run run --quiet my-tui-app
     """
     # Find app
     app_dir = get_app_dir(app_name)
@@ -41,6 +55,10 @@ def run(ctx, app_name: str, args: tuple[str, ...]) -> None:
         console.print(f"  [cyan]scry-run init --name {app_name} --description '...'[/cyan]")
         ctx.exit(1)
 
+    # Load per-app settings
+    app_settings = load_app_settings(app_dir)
+    default_flags = app_settings.get("default_flags", {})
+
     # Load config and convert to env vars
     config = load_config()
     env_vars = get_env_vars(config)
@@ -49,6 +67,12 @@ def run(ctx, app_name: str, args: tuple[str, ...]) -> None:
     env = os.environ.copy()
     env.update(env_vars)
 
+    # Set quiet mode if requested via flag OR app default
+    # CLI flag takes precedence over app settings
+    use_quiet = quiet or default_flags.get("quiet", False)
+    if use_quiet:
+        env["SCRY_QUIET"] = "1"
+
     # Clear venv-related environment variables to prevent interference
     # from an activated venv (uv run --directory will use the app's venv)
     env.pop("VIRTUAL_ENV", None)

{scry_run-0.1.1 → scry_run-0.1.2}/src/scry_run/console.py

@@ -1,5 +1,7 @@
 """Console output utilities for consistent styling."""
 
+import os
+import sys
 from datetime import datetime
 
 from rich.console import Console
@@ -8,23 +10,46 @@ from rich.console import Console
 err_console = Console(stderr=True, highlight=False)
 
 
+def _is_quiet() -> bool:
+    """Check if quiet mode is enabled (SCRY_QUIET=1)."""
+    return os.environ.get("SCRY_QUIET", "").lower() in ("1", "true", "yes", "on")
+
+
+def _set_title(msg: str) -> None:
+    """Set terminal title bar. Used in quiet mode to show progress."""
+    # OSC escape sequence to set window title
+    # \033]0; sets both window title and icon name
+    # \007 is the bell character that terminates the sequence
+    sys.stderr.write(f"\033]0;[scry-run] {msg}\007")
+    sys.stderr.flush()
+
+
 def _timestamp() -> str:
     """Return current time as HH:MM:SS."""
     return datetime.now().strftime("%H:%M:%S")
 
 
 def status(msg: str) -> None:
-    """Print a dim status message."""
+    """Print a dim status message. Uses title bar in quiet mode."""
+    if _is_quiet():
+        _set_title(msg)
+        return
     err_console.print(f"[dim]{_timestamp()} \\[scry-run][/dim] {msg}")
 
 
 def info(msg: str) -> None:
-    """Print an info message (cyan)."""
+    """Print an info message (cyan). Uses title bar in quiet mode."""
+    if _is_quiet():
+        _set_title(msg)
+        return
     err_console.print(f"[dim]{_timestamp()}[/dim] [cyan]\\[scry-run][/cyan] {msg}")
 
 
 def success(msg: str) -> None:
-    """Print a success message (green)."""
+    """Print a success message (green). Uses title bar in quiet mode."""
+    if _is_quiet():
+        _set_title(f"✓ {msg}")
+        return
     err_console.print(f"[dim]{_timestamp()}[/dim] [green]\\[scry-run][/green] {msg}")
 
 
@@ -39,21 +64,33 @@ def error(msg: str) -> None:
 
 
 def generating(class_name: str, attr_name: str) -> None:
-    """Print a 'generating' message."""
+    """Print a 'generating' message. Uses title bar in quiet mode."""
+    if _is_quiet():
+        _set_title(f"Generating {class_name}.{attr_name}...")
+        return
     err_console.print(f"[dim]{_timestamp()}[/dim] [cyan]\\[scry-run][/cyan] Generating {class_name}.{attr_name}...")
 
 
 def generated(class_name: str, attr_name: str) -> None:
-    """Print a 'generated' success message."""
+    """Print a 'generated' success message. Uses title bar in quiet mode."""
+    if _is_quiet():
+        _set_title(f"✓ Generated {class_name}.{attr_name}")
+        return
     err_console.print(f"[dim]{_timestamp()}[/dim] [green]\\[scry-run][/green] Generated {class_name}.{attr_name} ✓")
 
 
 def using_cached(class_name: str, attr_name: str) -> None:
-    """Print a 'using cached' message."""
+    """Print a 'using cached' message. Uses title bar in quiet mode."""
+    if _is_quiet():
+        _set_title(f"Using cached {class_name}.{attr_name}")
+        return
     err_console.print(f"[dim]{_timestamp()} \\[scry-run][/dim] Using cached {class_name}.{attr_name}")
 
 
 def backend_selected(backend_name: str, model: str | None, reason: str) -> None:
-    """Print backend selection message."""
+    """Print backend selection message. Uses title bar in quiet mode."""
+    if _is_quiet():
+        _set_title(f"Backend: {backend_name}")
+        return
     model_str = f" (model={model})" if model else ""
     err_console.print(f"[dim]{_timestamp()} \\[scry-run][/dim] Using backend: {backend_name}{model_str} ({reason})")

{scry_run-0.1.1 → scry_run-0.1.2}/src/scry_run/logging.py

@@ -17,14 +17,14 @@ class ScryRunLogger:
     Log file is created in:
     1. The app's logs/ directory (if running in an app context)
     2. Directory specified by SCRY_LOG_DIR
-    3. Current working directory (fallback)
+    3. ~/.scry-run/logs/ (fallback for CLI commands)
     """
-    
+
     _instance: Optional["ScryRunLogger"] = None
-    
+
     def __init__(self, log_dir: Optional[Path] = None):
         """Initialize logger.
-        
+
         Args:
             log_dir: Directory for log file. If None, uses auto-detection.
         """
@@ -32,24 +32,27 @@ class ScryRunLogger:
         self._log_file: Optional[Path] = None
         # Session timestamp for unique log files per run
         self._session_id = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
-        
+
         if log_dir:
             self._log_dir = log_dir
         else:
             env_dir = os.environ.get("SCRY_LOG_DIR")
             if env_dir:
                 self._log_dir = Path(env_dir)
-        
+
         # Debug logging is ON by default. Set SCRY_DEBUG=0 to disable.
         debug_env = os.environ.get("SCRY_DEBUG", "").lower()
         self._enabled = debug_env not in ("0", "false", "no", "off")
-    
+
     @property
     def log_dir(self) -> Path:
-        """Get log directory, with fallback to cwd."""
+        """Get log directory, with fallback to ~/.scry-run/logs/."""
         if self._log_dir:
             return self._log_dir
-        return Path.cwd()
+        # Fallback to global scry-run logs directory (not cwd)
+        fallback = Path.home() / ".scry-run" / "logs"
+        fallback.mkdir(parents=True, exist_ok=True)
+        return fallback
     
     @property  
     def log_file(self) -> Path:

{scry_run-0.1.1 → scry_run-0.1.2}/uv.lock

@@ -1028,7 +1028,7 @@ wheels = [
 
 [[package]]
 name = "scry-run"
-version = "0.1.0"
+version = "0.1.2"
 source = { editable = "." }
 dependencies = [
     { name = "claude-agent-sdk" },