sscli 2.1.0__tar.gz → 2.2.0__tar.gz

{sscli-2.1.0 → sscli-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sscli
-Version: 2.1.0
+Version: 2.2.0
 Summary: Seed & Source CLI - Multi-tenant SaaS scaffolding with Seed & Source Core
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -13,50 +13,49 @@ Requires-Dist: python-dotenv
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: httpx>=0.27.0
 
-# Seed & Source CLI v1.1.0
+# Seed & Source CLI v2.2.0
 
-Unified interface for Seed & Source templates. Now with **Seed & Source Core** — production-ready multi-tenant SaaS APIs.
+Unified interface for Seed & Source templates. Now with **Seed & Source Core** and **The Central Vault**.
 
 ## 🎯 What is sscli?
 
-`sscli` scaffolds complete, enterprise-grade SaaS stacks with:
-- ✅ Multi-tenant isolation (database-level RLS)
-- ✅ Third-party integrations (Shopify, Stripe, WooCommerce)
-- ✅ Hexagonal Architecture (clean, testable code)
-- ✅ Security by default (HMAC validation, RLS policies)
-- ✅ Ready-to-deploy applications
+`sscli` scaffolds complete, enterprise-grade SaaS stacks. As part of the **Great Decoupling**, our templates are now "Lean Cores", with high-value proprietary features (Commerce, Admin, Tunnels) managed via a central vault and injected at setup time.
+
+- ✅ **Lean Cores**: Free, high-performance base templates for Rails, Python, and Astro.
+- ✅ **The Vault**: Proprietary high-value features (Commerce, Admin, Tunnels) injected on-demand.
+- ✅ **Multi-tenant isolation**: Pre-configured database-level security.
+- ✅ **Hexagonal Architecture**: Clean separation between domain logic and infrastructure.
 
 ## 📦 Quick Install
 
 ```bash
 # Via pip
-pip install sscli==1.1.0
+pip install sscli==2.1.0
 
 # Via pipx (recommended)
-pipx install sscli==1.1.0
+pipx install sscli==2.1.0
 
 # Verify
 sscli --version
-# Output: sscli 1.1.0
+# Output: sscli 2.1.0
 ```
 
 ## 🚀 Quick Start
 
-### Create a Multi-Tenant Rails API
+### Create a Multi-Tenant Rails API (Lean Core + Commerce Vault)
 
 ```bash
 sscli new \
   --template rails-api \
   --name my-saas-api \
-  --with-commerce \
-  --with-shopify
+  --with-commerce
 ```
 
 This scaffolds:
-- Rails 8.0 API with PostgreSQL
-- Multi-tenant core (Tenant → Integration → CommercialAgreement → SecurityToken)
+- Rails 8.0 API with PostgreSQL (Lean Core)
+- **Vault Injection**: Pluggable Commerce adapters and and webhooks.
+- Multi-tenant core (Tenants, API Keys, etc.)
 - HMAC webhook validation
-- Shopify adapter (ready for orders/create webhooks)
 - Row-Level Security (RLS) enforcement
 
 ### Create a Python SaaS Backend
@@ -88,16 +87,27 @@ This scaffolds:
 - Tailwind CSS
 - TypeScript
 
-## 📋 Available Templates
+## 📋 Available Templates (Lean Cores)
+
+| Template | Tier | Description |
+|----------|------|-------------|
+| `rails-api` | **FREE** | Multi-tenant Rails API |
+| `python-saas` | **FREE** | Python SaaS Boilerplate |
+| `static-landing` | **FREE** | Astro Static Landing Page |
+| `react-client` | ALPHA | React + Vite frontend |
+| `data-pipeline` | ALPHA | dbt + Airflow pipeline |
+
+## 💎 High-Value Feature Vault (Premium)
+
+These modules are managed in the central private vault and injected on-demand into the Lean Cores:
 
-| Template | Description | Use Case |
-|----------|-------------|----------|
-| `rails-api` | Multi-tenant Rails API (v1.1.0) | SaaS backends, microservices |
-| `python-saas` | Python FastAPI backend | Data processing, ML services |
-| `react-client` | React + Vite frontend | Web UIs, dashboards |
-| `data-pipeline` | dbt + Airflow pipeline | Analytics, ETL |
-| `mobile-android` | Android native app | Mobile apps |
-| `mobile-ios` | iOS Swift app | Mobile apps |
+| Feature | Tier | Description |
+|---------|------|-------------|
+| `commerce` | **PRO** | Shopify/Stripe adapters, webhooks, and commerce models |
+| `admin` | **PRO** | Standalone NiceGUI-based admin dashboard |
+| `tunnel` | **PRO** | Automated ngrok config for local webhook testing |
+| `sqlite` | ALPHA | Local persistence adapter (SQLAlchemy/Alembic) |
+| `ingestor` | **PRO** | Data Ingestor adapter for raw normalization |
 
 ## 🔧 CLI Commands
 

{sscli-2.1.0 → sscli-2.2.0}/README.md

@@ -1,47 +1,46 @@
-# Seed & Source CLI v1.1.0
+# Seed & Source CLI v2.2.0
 
-Unified interface for Seed & Source templates. Now with **Seed & Source Core** — production-ready multi-tenant SaaS APIs.
+Unified interface for Seed & Source templates. Now with **Seed & Source Core** and **The Central Vault**.
 
 ## 🎯 What is sscli?
 
-`sscli` scaffolds complete, enterprise-grade SaaS stacks with:
-- ✅ Multi-tenant isolation (database-level RLS)
-- ✅ Third-party integrations (Shopify, Stripe, WooCommerce)
-- ✅ Hexagonal Architecture (clean, testable code)
-- ✅ Security by default (HMAC validation, RLS policies)
-- ✅ Ready-to-deploy applications
+`sscli` scaffolds complete, enterprise-grade SaaS stacks. As part of the **Great Decoupling**, our templates are now "Lean Cores", with high-value proprietary features (Commerce, Admin, Tunnels) managed via a central vault and injected at setup time.
+
+- ✅ **Lean Cores**: Free, high-performance base templates for Rails, Python, and Astro.
+- ✅ **The Vault**: Proprietary high-value features (Commerce, Admin, Tunnels) injected on-demand.
+- ✅ **Multi-tenant isolation**: Pre-configured database-level security.
+- ✅ **Hexagonal Architecture**: Clean separation between domain logic and infrastructure.
 
 ## 📦 Quick Install
 
 ```bash
 # Via pip
-pip install sscli==1.1.0
+pip install sscli==2.1.0
 
 # Via pipx (recommended)
-pipx install sscli==1.1.0
+pipx install sscli==2.1.0
 
 # Verify
 sscli --version
-# Output: sscli 1.1.0
+# Output: sscli 2.1.0
 ```
 
 ## 🚀 Quick Start
 
-### Create a Multi-Tenant Rails API
+### Create a Multi-Tenant Rails API (Lean Core + Commerce Vault)
 
 ```bash
 sscli new \
   --template rails-api \
   --name my-saas-api \
-  --with-commerce \
-  --with-shopify
+  --with-commerce
 ```
 
 This scaffolds:
-- Rails 8.0 API with PostgreSQL
-- Multi-tenant core (Tenant → Integration → CommercialAgreement → SecurityToken)
+- Rails 8.0 API with PostgreSQL (Lean Core)
+- **Vault Injection**: Pluggable Commerce adapters and and webhooks.
+- Multi-tenant core (Tenants, API Keys, etc.)
 - HMAC webhook validation
-- Shopify adapter (ready for orders/create webhooks)
 - Row-Level Security (RLS) enforcement
 
 ### Create a Python SaaS Backend
@@ -73,16 +72,27 @@ This scaffolds:
 - Tailwind CSS
 - TypeScript
 
-## 📋 Available Templates
+## 📋 Available Templates (Lean Cores)
+
+| Template | Tier | Description |
+|----------|------|-------------|
+| `rails-api` | **FREE** | Multi-tenant Rails API |
+| `python-saas` | **FREE** | Python SaaS Boilerplate |
+| `static-landing` | **FREE** | Astro Static Landing Page |
+| `react-client` | ALPHA | React + Vite frontend |
+| `data-pipeline` | ALPHA | dbt + Airflow pipeline |
+
+## 💎 High-Value Feature Vault (Premium)
+
+These modules are managed in the central private vault and injected on-demand into the Lean Cores:
 
-| Template | Description | Use Case |
-|----------|-------------|----------|
-| `rails-api` | Multi-tenant Rails API (v1.1.0) | SaaS backends, microservices |
-| `python-saas` | Python FastAPI backend | Data processing, ML services |
-| `react-client` | React + Vite frontend | Web UIs, dashboards |
-| `data-pipeline` | dbt + Airflow pipeline | Analytics, ETL |
-| `mobile-android` | Android native app | Mobile apps |
-| `mobile-ios` | iOS Swift app | Mobile apps |
+| Feature | Tier | Description |
+|---------|------|-------------|
+| `commerce` | **PRO** | Shopify/Stripe adapters, webhooks, and commerce models |
+| `admin` | **PRO** | Standalone NiceGUI-based admin dashboard |
+| `tunnel` | **PRO** | Automated ngrok config for local webhook testing |
+| `sqlite` | ALPHA | Local persistence adapter (SQLAlchemy/Alembic) |
+| `ingestor` | **PRO** | Data Ingestor adapter for raw normalization |
 
 ## 🔧 CLI Commands
 

{sscli-2.1.0 → sscli-2.2.0}/foundry/actions/development.py

@@ -281,16 +281,18 @@ def run_swap(target=None):
             wheel = wheels[0]
             console.print(f"  Installing from [cyan]{wheel.name}[/cyan]...")
             
+            import os
+            python_exe = venv_path / 'bin' / 'python'
+            
             result = subprocess.run(
-                [str(venv_bin / 'pip'), 'install', '--force-reinstall', str(wheel)],
+                [str(python_exe), '-m', 'pip', 'install', '--force-reinstall', str(wheel)],
                 capture_output=True,
                 text=True
             )
             
             if result.returncode != 0:
                 console.print("[red]✗ Installation failed[/red]")
-                if "--force-reinstall" in result.stderr:
-                    console.print(result.stderr)
+                console.print(f"[dim]Error details: {result.stderr[:200]}[/dim]")
                 return False
             
             console.print("[green]✓ Switched to local build[/green]")
@@ -303,14 +305,18 @@ def run_swap(target=None):
             
             console.print(f"  Installing sscli=={pip_version} from PyPI...")
             
+            import os
+            python_exe = venv_path / 'bin' / 'python'
+            
             result = subprocess.run(
-                [str(venv_bin / 'pip'), 'install', '--force-reinstall', f'sscli=={pip_version}'],
+                [str(python_exe), '-m', 'pip', 'install', '--force-reinstall', f'sscli=={pip_version}'],
                 capture_output=True,
                 text=True
             )
             
             if result.returncode != 0:
                 console.print("[red]✗ Installation failed[/red]")
+                console.print(f"[dim]Error details: {result.stderr[:200]}[/dim]")
                 return False
             
             console.print("[green]✓ Switched to pip package[/green]")
@@ -322,10 +328,93 @@ def run_swap(target=None):
     
     return False
 
+def run_bump_version(bump_type=None, auto_confirm=False):
+    """Run the bump version script interactively or with specified type."""
+    stack_cli_root = get_stack_cli_root()
+    bin_dir = stack_cli_root / 'bin'
+    bump_script = bin_dir / 'sscli-bump-version'
+    
+    if not bump_script.exists():
+        console.print("[red]✗ Bump script not found at[/red]", bump_script)
+        return False
+    
+    # If bump_type is not provided, ask interactively
+    if bump_type is None:
+        console.print("")
+        console.print("[bold cyan]Version Bump Utility[/bold cyan]")
+        console.print("")
+        
+        # Ask which version to bump
+        bump_type = questionary.select(
+            "Select version bump type:",
+            choices=[
+                questionary.Choice("Major (X.0.0)", value="major"),
+                questionary.Choice("Minor (x.Y.0)", value="minor"),
+                questionary.Choice("Patch (x.y.Z)", value="patch"),
+                questionary.Choice("Cancel", value="cancel"),
+            ],
+        ).ask()
+        
+        if not bump_type or bump_type == "cancel":
+            console.print("[yellow]Cancelled[/yellow]")
+            return False
+        
+        # In interactive mode through the dev menu, let the script ask for confirmation
+        auto_confirm = False
+    
+    console.print("")
+    try:
+        # Prepare environment for the bash script
+        import os
+        env = os.environ.copy()
+        
+        # Build command
+        cmd = [str(bump_script), bump_type]
+        stdin_input = None
+        
+        if auto_confirm:
+            # For non-interactive CLI usage, auto-confirm by feeding 'y' to stdin
+            stdin_input = "y\n"
+        
+        result = subprocess.run(
+            cmd,
+            input=stdin_input,
+            capture_output=True,
+            text=True,
+            env=env
+        )
+        
+        # Print script output
+        if result.stdout:
+            console.print(result.stdout)
+        
+        if result.returncode != 0:
+            if result.stderr:
+                console.print("[red]Error:[/red]")
+                console.print(result.stderr)
+            return False
+        
+        return True
+    
+    except Exception as e:
+        console.print(f"[red]✗ Bump failed: {e}[/red]")
+        return False
+
 def dev_tools_menu():
     """Interactive menu for development tools."""
     # Check if running in development context
-    if not is_internal_dev():
+    # Check environment variable first (takes precedence for CLI wrapper scripts)
+    import os
+    from pathlib import Path
+    foundry_root = os.getenv("FOUNDRY_ROOT")
+    if foundry_root:
+        root_path = Path(foundry_root)
+        markers = [".github", "docs", "tooling", "wiring"]
+        is_dev = all((root_path / marker).exists() for marker in markers)
+    else:
+        is_dev = is_internal_dev()
+    
+    if not is_dev:
         console.print("[yellow]⚠️  Development tools are only available in development mode.[/yellow]")
         return
     
@@ -340,6 +429,7 @@ def dev_tools_menu():
             questionary.Choice("📊 Show Development Status", value="status"),
             questionary.Choice("🔨 Build Distribution Package", value="build"),
             questionary.Choice("🔄 Switch Build Source (Local ↔ Pip)", value="swap"),
+            questionary.Choice("📌 Bump Version (major/minor/patch)", value="bump"),
             questionary.Choice("← Back to Main Menu", value="back"),
         ]
         
@@ -392,6 +482,12 @@ def dev_tools_menu():
                 else:
                     console.print("[red]✗[/red] Swap failed")
         
+        elif selection == "bump":
+            if run_bump_version():
+                console.print("[green]✓[/green] Version bump complete")
+            else:
+                console.print("[red]✗[/red] Version bump failed")
+        
         console.print("")
         input("[dim]Press Enter to continue...[/dim]")
         console.clear()

sscli-2.2.0/foundry/actions/explore.py

@@ -0,0 +1,227 @@
+from foundry.constants import console, TIER_HIERARCHY, QUESTIONARY_STYLE, TEMPLATE_REGISTRY
+from foundry.utils import get_templates, get_template_info
+from foundry.auth import get_current_license_info
+from rich.panel import Panel
+from rich.tree import Tree
+import questionary
+from questionary import Choice
+from prompt_toolkit.key_binding import KeyBindings
+import re
+
+
+def _get_template_tech(name):
+    """Get technology stack for a template by name."""
+    # Map template names to tech descriptions
+    tech_map = {
+        "python-saas": "Python (FastAPI/SQLAlchemy)",
+        "rails-api": "Ruby on Rails",
+        "react-client": "React/Vite",
+        "rails-ui-kit": "Rails + ViewComponent",
+        "static-landing": "Astro (Static Site)",
+        "mobile-android": "Android (Kotlin/Compose)",
+        "mobile-ios": "iOS (Swift/SwiftUI)",
+        "data-pipeline": "Data Stack (dbt + Python)",
+        "terraform-infra": "Terraform (Multi-cloud)",
+        "wiring": "Docker Orchestration",
+    }
+    return tech_map.get(name, "Multi-tech Stack")
+
+
+def _strip_markup(text):
+    """Remove Rich markup tags from text."""
+    return re.sub(r'\[/?[^\]]+\]', '', text)
+
+
+def _render_templates_tree(buckets):
+    """Render a tree view with all categories expanded showing available templates."""
+    tree = Tree("[bold green]Seed & Source Inventory[/bold green]")
+
+    for category, items in buckets.items():
+        if not items:
+            continue
+
+        count = len(items)
+        cat_node = tree.add(f"[bold yellow]▼ {category} ({count})[/bold yellow]")
+        
+        for item in items:
+            node = cat_node.add(f"[bold cyan]{item['name']}[/bold cyan]")
+            # Show tier badge in tree
+            if item['tier'] != "free":
+                tier_display = f"(🔐 {item['tier'].upper()})" if item['locked'] else f"(✅ {item['tier'].upper()})"
+                node.add(f"[yellow]{tier_display}[/yellow]")
+            # Show tech
+            tech = _get_template_tech(item['name'])
+            node.add(f"[dim]{tech}[/dim]")
+
+    console.print(Panel(tree, title="Available Templates", border_style="green"))
+
+
+def _show_template_info(name):
+    """Show detailed information about a template."""
+    info = get_template_info(name)
+    tech = _get_template_tech(name)
+    
+    content = f"[bold cyan]Name:[/bold cyan] {name}\n"
+    content += f"[bold cyan]Tech:[/bold cyan] {tech}\n"
+    content += f"[bold cyan]Tier:[/bold cyan] {info.get('tier', 'free').upper()}\n"
+    content += f"[bold cyan]Repo:[/bold cyan] {info.get('repo', 'N/A')}\n\n"
+    content += f"[italic]{info.get('description', 'No detailed description available.')}[/italic]"
+    
+    console.print(Panel(content, title=f"Template Details: {name}", border_style="cyan", expand=False))
+    questionary.press_any_key_to_continue().ask()
+
+
+def run_explore():
+    """Interactive template explorer with collapsible tree and selectable templates."""
+    # Get user info for tier checking
+    user_info = get_current_license_info()
+    user_tier = user_info.get("tier", "free")
+    user_rank = TIER_HIERARCHY.get(user_tier, 0)
+
+    # Group templates by category
+    buckets = {
+        "Backend Services": [],
+        "Frontend & UI": [],
+        "Mobile App": [],
+        "Data Engineering": [],
+        "Infrastructure": [],
+        "Other": [],
+    }
+
+    templates = get_templates()
+
+    for tmpl in templates:
+        name = tmpl.name
+        # Fetch metadata to get the tier
+        info = get_template_info(name)
+        tmpl_tier = info.get("tier", "free").lower()
+        tmpl_rank = TIER_HIERARCHY.get(tmpl_tier, 0)
+
+        # Check if locked
+        locked = tmpl_rank > user_rank
+        
+        # Store template data for processing
+        tmpl_data = {
+            "name": name,
+            "tier": tmpl_tier,
+            "locked": locked,
+        }
+
+        if name in ["python-saas", "rails-api"]:
+            buckets["Backend Services"].append(tmpl_data)
+        elif name in ["react-client", "rails-ui-kit", "static-landing"]:
+            buckets["Frontend & UI"].append(tmpl_data)
+        elif name.startswith("mobile-"):
+            buckets["Mobile App"].append(tmpl_data)
+        elif name == "data-pipeline":
+            buckets["Data Engineering"].append(tmpl_data)
+        elif name == "terraform-infra":
+            buckets["Infrastructure"].append(tmpl_data)
+        else:
+            buckets["Other"].append(tmpl_data)
+
+    # Remove empty categories
+    buckets = {k: v for k, v in buckets.items() if v}
+    
+    # State for collapsible sections - start collapsed as requested
+    expanded_categories = set()
+    last_selected_value = f"toggle:{list(buckets.keys())[0]}" if buckets else None
+    
+    # Custom Keybindings for Left/Right arrows
+    kb = KeyBindings()
+    @kb.add("left")
+    @kb.add("right")
+    def _(event):
+        # Map left/right arrows to Enter (submit) to trigger the toggle/select loop
+        event.app.key_processor.feed_text("\n")
+
+    # ANSI Colors for visual richness
+    YELLOW = "\033[33m"
+    BLUE = "\033[34m"
+    CYAN = "\033[36m"
+    GREEN = "\033[32m"
+    RED = "\033[31m"
+    MAGENTA = "\033[35m"
+    BOLD = "\033[1m"
+    RESET = "\033[0m"
+    
+    while True:
+        choices = []
+        for category, items in buckets.items():
+            is_expanded = category in expanded_categories
+            symbol = "▼" if is_expanded else "▶"
+            count = len(items)
+            
+            # Category choice - Base Yellow
+            choices.append(Choice(
+                title=f"{YELLOW}{symbol} {category} ({count}){RESET}",
+                value=f"toggle:{category}"
+            ))
+            
+            if is_expanded:
+                for i, item in enumerate(items):
+                    is_last = (i == len(items) - 1)
+                    connector = "  └─ " if is_last else "  ├─ "
+                    
+                    # Blue template names
+                    label = f"{connector}{BLUE}{item['name']}{RESET}"
+                    
+                    # Colored badges
+                    if item['locked']:
+                        label += f" {RED}🔐 LOCKED{RESET}"
+                    else:
+                        tier = item['tier']
+                        if tier == "alpha":
+                            label += f" {YELLOW}✅ ALPHA{RESET}"
+                        elif tier == "pro":
+                            label += f" {MAGENTA}✅ PRO{RESET}"
+                        elif tier == "free":
+                            label += f" {GREEN}✅ FREE{RESET}"
+                    
+                    # Tech description for the gray 3rd row (via patch)
+                    tech = _get_template_tech(item['name'])
+                    description = f"  Description: {tech}"
+                    
+                    choices.append(Choice(
+                        title=label,
+                        value=f"tmpl:{item['name']}",
+                        description=description
+                    ))
+        
+        choices.append(Choice("← Back to Main Menu", value="back"))
+
+        console.clear()
+        # Green frame that encompasses the header and instructions
+        console.print(Panel(
+            f"[bold green]Seed & Source Inventory[/bold green]\n"
+            f"[dim]Navigate with arrows. Use {BOLD}Enter/Right{RESET} [dim]to expand/select, {BOLD}Left{RESET} [dim]to collapse.[/dim]",
+            border_style="green",
+            padding=(1, 2)
+        ))
+        
+        selected = questionary.select(
+            "Select a template to view details:",
+            choices=choices,
+            style=questionary.Style(QUESTIONARY_STYLE),
+            use_indicator=True,
+            default=last_selected_value,
+            key_bindings=kb
+        ).ask()
+
+        if selected is None or selected == "back":
+            break
+            
+        last_selected_value = selected
+            
+        if selected.startswith("toggle:"):
+            cat = selected.split(":", 1)[1]
+            if cat in expanded_categories:
+                expanded_categories.remove(cat)
+            else:
+                expanded_categories.add(cat)
+            continue
+            
+        if selected.startswith("tmpl:"):
+            tmpl_name = selected.split(":", 1)[1]
+            _show_template_info(tmpl_name)
+