feat: redesign CLI welcome banner with ASP logo (#860)

* feat: redesign CLI welcome banner with ASP logo and random mottos

- Replace plain text banner with colored ASP ASCII art in a Rich Panel
- Add random fun mottos displayed on each run
- Show compact one-liner in auto-approve/programmatic mode
- Add banner to setup-cicd and register-gemini-enterprise commands

* add locks

* add locks

Author: eliasecchig

agent_starter_pack/cli/commands/create.py

@@ -335,7 +335,7 @@ def create(
 
         # Display welcome banner (unless skipped)
         if not skip_welcome:
-            display_welcome_banner(agent, agent_garden=agent_garden)
+            display_welcome_banner(agent, agent_garden=agent_garden, quiet=auto_approve)
 
         # Handle missing project name
         if not project_name:

agent_starter_pack/cli/commands/enhance.py

@@ -1030,7 +1030,7 @@ def enhance(
 
     # Display welcome banner for enhance command (unless skipped by nested command)
     if not skip_welcome:
-        display_welcome_banner(enhance_mode=True)
+        display_welcome_banner(enhance_mode=True, quiet=auto_approve)
 
     # Check for saved config and offer to reuse it
     # This handles both version locking AND reusing previous settings

agent_starter_pack/cli/commands/register_gemini_enterprise.py

@@ -34,6 +34,7 @@
     get_user_agent,
     get_x_goog_api_client_header,
 )
+from agent_starter_pack.cli.utils.logging import display_welcome_banner
 
 # TOML parser - use standard library for Python 3.11+, fallback to tomli
 if sys.version_info >= (3, 11):
@@ -1354,7 +1355,7 @@ def register_gemini_enterprise(
     This command can run interactively or accept all parameters via command-line options.
     If key parameters are missing, it will prompt the user for input.
     """
-    console.print("\n🤖 Agent → Gemini Enterprise Registration\n")
+    display_welcome_banner(register_mode=True, quiet=yes)
 
     # Read metadata file once to determine agent type and deployment target
     metadata = None

agent_starter_pack/cli/commands/setup_cicd.py

@@ -32,6 +32,7 @@
     is_github_authenticated,
     run_command,
 )
+from agent_starter_pack.cli.utils.logging import display_welcome_banner
 
 console = Console()
 
@@ -596,6 +597,7 @@ def setup_cicd(
     cicd_runner: str | None = None,
 ) -> None:
     """Set up CI/CD infrastructure using Terraform."""
+    display_welcome_banner(setup_cicd_mode=True, quiet=auto_approve)
 
     # Validate mutually exclusive flags
     if create_repository and use_existing_repository:

agent_starter_pack/cli/utils/logging.py

@@ -12,69 +12,141 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import importlib.metadata
+import random
 import sys
 from collections.abc import Callable
 from functools import wraps
 from typing import Any, TypeVar, cast
 
 from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
 
 console = Console()
 
+MOTTOS = [
+    "Your agents are cleared for takeoff.",
+    "Launching agents into production, one deploy at a time.",
+    "Houston, we have an agent.",
+    "To production... and beyond!",
+    "One small step for code, one giant leap for agents.",
+    "Fueling your AI agents with Google Cloud.",
+    "3... 2... 1... Agent deployed!",
+    "The sky is not the limit when you have agents.",
+]
+
 F = TypeVar("F", bound=Callable[..., Any])
 
 
+def _get_version() -> str:
+    """Get the package version, with fallback to 'dev'."""
+    try:
+        return importlib.metadata.version("agent-starter-pack")
+    except Exception:
+        return "dev"
+
+
+def _build_banner(line1: str, version: str, motto: str) -> Panel:
+    """Build a compact banner panel with ASP ASCII art logo."""
+    a = "bold blue"
+    s = "bold cyan"
+    p = "bold magenta"
+    logo = (
+        f"[{a}]▄▀▄[/] [{s}]█▀▀[/] [{p}]█▀▄[/]\n"
+        f"[{a}]█▀█[/] [{s}]▀▀█[/] [{p}]█▀▀[/]\n"
+        f"[{a}]▀ ▀[/] [{s}]▀▀▀[/] [{p}]▀[/]  "
+    )
+    right_text = f' [italic dim]"{motto}"[/]\n\n {line1}'
+    table = Table(
+        show_header=False,
+        show_edge=False,
+        show_lines=False,
+        padding=0,
+        pad_edge=False,
+    )
+    table.add_column(width=12)
+    table.add_column()
+    table.add_row(logo, right_text)
+    return Panel(
+        table,
+        title=f"Agent Starter Pack v{version}",
+        border_style="blue",
+        padding=(1, 2),
+    )
+
+
 def display_welcome_banner(
-    agent: str | None = None, enhance_mode: bool = False, agent_garden: bool = False
+    agent: str | None = None,
+    enhance_mode: bool = False,
+    agent_garden: bool = False,
+    setup_cicd_mode: bool = False,
+    register_mode: bool = False,
+    quiet: bool = False,
 ) -> None:
     """Display the Agent Starter Pack welcome banner.
 
     Args:
         agent: Optional agent specification to customize the welcome message
         enhance_mode: Whether this is for enhancement mode
         agent_garden: Whether this deployment is from Agent Garden
+        setup_cicd_mode: Whether this is for CI/CD setup
+        register_mode: Whether this is for Gemini Enterprise registration
+        quiet: If True, skip the banner (e.g. in auto-approve/programmatic mode)
     """
+    version = _get_version()
+    if quiet:
+        console.print(f"[bold blue]Agent Starter Pack[/] [dim]v{version}[/]")
+        return
+
+    motto = random.choice(MOTTOS)
+
     if enhance_mode:
-        console.print(
-            "\n=== Google Cloud Agent Starter Pack 🚀===",
-            style="bold blue",
+        panel = _build_banner(
+            line1="Enhancing your project with production-ready capabilities!",
+            version=version,
+            motto=motto,
         )
-        console.print(
-            "Enhancing your existing project with production-ready agent capabilities!\n",
-            style="green",
+    elif setup_cicd_mode:
+        panel = _build_banner(
+            line1="Setting up CI/CD infrastructure for your agent!",
+            version=version,
+            motto=motto,
         )
-    elif agent_garden:
-        console.print(
-            "\n=== Welcome to Agent Garden! 🌱 ===",
-            style="bold blue",
-        )
-        console.print(
-            "Powered by [link=https://goo.gle/agent-starter-pack]Google Cloud - Agent Starter Pack [/link]\n",
+    elif register_mode:
+        panel = _build_banner(
+            line1="Registering your agent to Gemini Enterprise!",
+            version=version,
+            motto=motto,
         )
-        console.print(
-            "This tool will help you deploy production-ready AI agents from Agent Garden to Google Cloud!\n"
+    elif agent_garden:
+        panel = _build_banner(
+            line1=(
+                "Powered by [link=https://goo.gle/agent-starter-pack]"
+                "Google Cloud - Agent Starter Pack[/link]"
+            ),
+            version=version,
+            motto=motto,
         )
     elif agent and agent.startswith("adk@"):
-        console.print(
-            "\n=== Welcome to [link=https://github.com/google/adk-samples]google/adk-samples[/link]! ✨ ===",
-            style="bold blue",
-        )
-        console.print(
-            "Powered by [link=https://goo.gle/agent-starter-pack]Google Cloud - Agent Starter Pack [/link]\n",
-        )
-        console.print(
-            "This tool will help you create an end-to-end production-ready AI agent in Google Cloud!\n"
+        panel = _build_banner(
+            line1=(
+                "Powered by [link=https://goo.gle/agent-starter-pack]"
+                "Google Cloud - Agent Starter Pack[/link]"
+            ),
+            version=version,
+            motto=motto,
         )
     else:
-        console.print(
-            "\n=== Google Cloud Agent Starter Pack 🚀===",
-            style="bold blue",
-        )
-        console.print("Welcome to the Agent Starter Pack!")
-        console.print(
-            "This tool will help you create an end-to-end production-ready AI agent in Google Cloud!\n"
+        panel = _build_banner(
+            line1="Create production-ready AI agents on Google Cloud!",
+            version=version,
+            motto=motto,
         )
 
+    console.print()
+    console.print(panel)
+
 
 def handle_cli_error(f: F) -> F:
     """Decorator to handle CLI errors gracefully.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-starter-pack"
-version = "0.39.0"
+version = "0.38.0"
 description = "CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates."
 authors = [
     { name = "Google LLC", email = "agent-starter-pack@google.com" },