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

{scry_run-0.1.0 → 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.2/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: scry-run
+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
+Author: Krzysztof Skrzętnicki
+License: MIT
+Keywords: ai,claude,code-generation,llm,metaclass
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: claude-agent-sdk>=0.1.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# scry-run
+
+**Describe an app, run it.** A CLI tool that generates and runs Python applications from natural language descriptions.
+
+## Installation
+
+```bash
+uv tool install scry-run
+```
+
+Or run without installing:
+
+```bash
+uvx scry-run --help
+```
+
+Requires [Claude Code CLI](https://github.com/anthropics/claude-code) to be installed.
+
+## Quick Start
+
+```bash
+# Create an app
+scry-run init --name=todoist --description='minimal web todo app'
+
+# Run it
+scry-run run todoist
+```
+
+## Demos
+
+### Creating a simple Hello World app
+
+![Hello Demo](demos/hello.gif)
+
+### Building a maze game with PyGame
+
+![Maze Demo](demos/maze.gif)
+
+## CLI Commands
+
+```bash
+# Create a new app
+scry-run init --name=NAME --description=DESC
+
+# List all apps
+scry-run list
+
+# Run an app
+scry-run run myapp [args...]
+
+# Get app info
+scry-run info myapp
+scry-run which myapp
+
+# Remove or reset an app
+scry-run rm myapp
+scry-run reset myapp
+
+# Cache management
+scry-run cache list myapp
+scry-run cache show myapp MyClass.method
+scry-run cache export myapp --output=code.py
+scry-run cache prune myapp --all
+```
+
+## Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `SCRY_RUN_BACKEND` | Backend: `claude`, `frozen`, or `auto` | `auto` |
+| `SCRY_RUN_MODEL` | Model override (e.g., `opus`) | (backend default) |
+
+## License
+
+MIT

scry_run-0.1.2/README.md

@@ -0,0 +1,75 @@
+# scry-run
+
+**Describe an app, run it.** A CLI tool that generates and runs Python applications from natural language descriptions.
+
+## Installation
+
+```bash
+uv tool install scry-run
+```
+
+Or run without installing:
+
+```bash
+uvx scry-run --help
+```
+
+Requires [Claude Code CLI](https://github.com/anthropics/claude-code) to be installed.
+
+## Quick Start
+
+```bash
+# Create an app
+scry-run init --name=todoist --description='minimal web todo app'
+
+# Run it
+scry-run run todoist
+```
+
+## Demos
+
+### Creating a simple Hello World app
+
+![Hello Demo](demos/hello.gif)
+
+### Building a maze game with PyGame
+
+![Maze Demo](demos/maze.gif)
+
+## CLI Commands
+
+```bash
+# Create a new app
+scry-run init --name=NAME --description=DESC
+
+# List all apps
+scry-run list
+
+# Run an app
+scry-run run myapp [args...]
+
+# Get app info
+scry-run info myapp
+scry-run which myapp
+
+# Remove or reset an app
+scry-run rm myapp
+scry-run reset myapp
+
+# Cache management
+scry-run cache list myapp
+scry-run cache show myapp MyClass.method
+scry-run cache export myapp --output=code.py
+scry-run cache prune myapp --all
+```
+
+## Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `SCRY_RUN_BACKEND` | Backend: `claude`, `frozen`, or `auto` | `auto` |
+| `SCRY_RUN_MODEL` | Model override (e.g., `opus`) | (backend default) |
+
+## License
+
+MIT

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

@@ -1,6 +1,6 @@
 [project]
 name = "scry-run"
-version = "0.1.0"
+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.0 → scry_run-0.1.2}/src/scry_run/backends/frozen.py

@@ -1,7 +1,7 @@
 """Frozen backend - errors on any generation attempt.
 
-This backend is used for "baked" apps that should only use cached methods.
-Any attempt to generate new code will raise FrozenAppError.
+This backend is used when code generation should be disabled and only cached methods
+should be used. Any attempt to generate new code will raise FrozenAppError.
 """
 
 from typing import Optional
@@ -14,8 +14,8 @@ class FrozenAppError(RuntimeError):
     """Raised when a frozen app attempts to generate code.
 
     This error indicates that a method was called that doesn't exist
-    in the cache of a baked/frozen app. The app needs to be "unbaked"
-    or the method needs to be added to the cache before baking.
+    in the cache of a frozen app. The backend needs to be changed to allow
+    generation, or the method needs to be pre-generated and cached.
     """
 
     def __init__(self, class_name: str, attr_name: str):
@@ -24,7 +24,7 @@ class FrozenAppError(RuntimeError):
         super().__init__(
             f"Frozen app cannot generate code for '{class_name}.{attr_name}'. "
             f"This method is not in the cache. Either:\n"
-            f"  1. Run the original app to generate this method, then re-bake\n"
+            f"  1. Run the app with a real backend to generate this method first\n"
             f"  2. Set _llm_backend to a real backend (e.g., 'claude') to unfreeze"
         )
 
@@ -32,7 +32,7 @@ class FrozenAppError(RuntimeError):
 class FrozenBackend(GeneratorBackend):
     """Backend that refuses to generate any code.
 
-    Used for baked apps where all methods should come from cache.
+    Used when all methods should come from cache and generation is disabled.
     Any generation attempt raises FrozenAppError with helpful message.
     """
 

{scry_run-0.1.0 → 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,11 +423,14 @@ 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")
     console.print(f"  [cyan]scry-run cache list {name}[/cyan]  List generated methods")
-    console.print(f"  [cyan]scry-run bake {name}[/cyan]        Export as standalone package")
     console.print()
     console.print("[dim]Methods are generated on first use using Claude CLI.[/dim]")

{scry_run-0.1.0 → 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.2/src/scry_run/console.py

@@ -0,0 +1,96 @@
+"""Console output utilities for consistent styling."""
+
+import os
+import sys
+from datetime import datetime
+
+from rich.console import Console
+
+# Stderr console for status messages
+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. 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). 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). 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}")
+
+
+def warning(msg: str) -> None:
+    """Print a warning message (yellow)."""
+    err_console.print(f"[dim]{_timestamp()}[/dim] [yellow]\\[scry-run][/yellow] {msg}")
+
+
+def error(msg: str) -> None:
+    """Print an error message (red)."""
+    err_console.print(f"[dim]{_timestamp()}[/dim] [red]\\[scry-run][/red] {msg}")
+
+
+def generating(class_name: str, attr_name: str) -> None:
+    """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. 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. 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. 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.0 → scry_run-0.1.2}/src/scry_run/generator.py

@@ -603,8 +603,31 @@ IMPORTANT: Output ONLY the JSON object, no markdown, no explanation, no code fen
 
         # Delegate to backend with retries
         last_error: Optional[Exception] = None
+        previous_errors: list[str] = []  # Track errors for feedback
 
         for attempt in range(self.MAX_RETRIES):
+            # Build error feedback for retry attempts
+            error_feedback = ""
+            if previous_errors:
+                error_feedback = f"""
+
+## PREVIOUS GENERATION FAILED
+
+This is generation attempt #{attempt + 1}. Previous attempt(s) caused errors:
+
+{chr(10).join(f"- Attempt #{i+1}: {err}" for i, err in enumerate(previous_errors))}
+
+Please analyze these errors and generate FIXED code that avoids them.
+"""
+
+            # Rebuild prompt with error feedback if needed
+            if error_feedback:
+                if supports_context:
+                    prompt = self._build_frame_prompt(class_name, attr_name, is_classmethod, runtime_context + error_feedback)
+                else:
+                    prompt = self._build_prompt(context + error_feedback, class_name, attr_name, is_classmethod, installed_packages)
+                logger.log_generation_start(class_name, attr_name, prompt)
+
             try:
                 result = self._backend.generate_code(prompt)
                 
@@ -645,7 +668,15 @@ IMPORTANT: Output ONLY the JSON object, no markdown, no explanation, no code fen
                 # Log the validation error with full details
                 code_str = result.code if 'result' in dir() and hasattr(result, 'code') else None
                 logger.log_validation_error(e, code_str)
-                
+
+                # Track error for feedback on next attempt
+                error_msg = f"{type(e).__name__}: {e}"
+                if code_str:
+                    # Include a snippet of the problematic code
+                    code_preview = code_str[:200] + "..." if len(code_str) > 200 else code_str
+                    error_msg += f"\n  Generated code (preview): {code_preview}"
+                previous_errors.append(error_msg)
+
                 if attempt >= self.MAX_RETRIES - 1:
                     raise
                 warning(f"Validation error, retrying ({attempt + 1}/{self.MAX_RETRIES})...")

{scry_run-0.1.0 → 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: