emdash-cli 0.1.35__py3-none-any.whl → 0.1.67__py3-none-any.whl

emdash_cli/commands/server.py

@@ -10,6 +10,9 @@ from rich.console import Console
 
 console = Console()
 
+# Per-repo servers directory
+SERVERS_DIR = Path.home() / ".emdash" / "servers"
+
 
 @click.group()
 def server():
@@ -26,23 +29,41 @@ def server_killall():
     """
     killed = 0
 
-    # Kill by PID file first
-    pid_file = Path.home() / ".emdash" / "server.pid"
-    if pid_file.exists():
+    # Kill servers by PID files in servers directory
+    if SERVERS_DIR.exists():
+        for pid_file in SERVERS_DIR.glob("*.pid"):
+            try:
+                pid = int(pid_file.read_text().strip())
+                os.kill(pid, signal.SIGTERM)
+                console.print(f"[green]Killed server process {pid}[/green]")
+                killed += 1
+            except (ValueError, ProcessLookupError, PermissionError):
+                pass
+            finally:
+                # Clean up all files for this server
+                hash_prefix = pid_file.stem
+                for ext in [".port", ".pid", ".repo"]:
+                    server_file = SERVERS_DIR / f"{hash_prefix}{ext}"
+                    if server_file.exists():
+                        server_file.unlink(missing_ok=True)
+
+    # Also check legacy location
+    legacy_pid_file = Path.home() / ".emdash" / "server.pid"
+    if legacy_pid_file.exists():
         try:
-            pid = int(pid_file.read_text().strip())
+            pid = int(legacy_pid_file.read_text().strip())
             os.kill(pid, signal.SIGTERM)
-            console.print(f"[green]Killed server process {pid}[/green]")
+            console.print(f"[green]Killed legacy server process {pid}[/green]")
             killed += 1
         except (ValueError, ProcessLookupError, PermissionError):
             pass
         finally:
-            pid_file.unlink(missing_ok=True)
+            legacy_pid_file.unlink(missing_ok=True)
 
-    # Clean up port file
-    port_file = Path.home() / ".emdash" / "server.port"
-    if port_file.exists():
-        port_file.unlink(missing_ok=True)
+    # Clean up legacy port file
+    legacy_port_file = Path.home() / ".emdash" / "server.port"
+    if legacy_port_file.exists():
+        legacy_port_file.unlink(missing_ok=True)
 
     # Kill any remaining emdash_core.server processes
     try:
@@ -77,41 +98,79 @@ def server_killall():
 
 @server.command("status")
 def server_status():
-    """Show server status.
+    """Show status of all running servers.
 
     Example:
         emdash server status
     """
-    port_file = Path.home() / ".emdash" / "server.port"
-    pid_file = Path.home() / ".emdash" / "server.pid"
+    import httpx
 
-    if not port_file.exists():
-        console.print("[yellow]No server running[/yellow]")
-        return
+    servers_found = []
 
-    try:
-        port = int(port_file.read_text().strip())
-    except (ValueError, IOError):
-        console.print("[yellow]No server running (invalid port file)[/yellow]")
-        return
+    # Check per-repo servers directory
+    if SERVERS_DIR.exists():
+        for port_file in SERVERS_DIR.glob("*.port"):
+            try:
+                port = int(port_file.read_text().strip())
+                hash_prefix = port_file.stem
 
-    # Check if server is responsive
-    import httpx
-    try:
-        response = httpx.get(f"http://localhost:{port}/api/health", timeout=2.0)
-        if response.status_code == 200:
-            pid = "unknown"
-            if pid_file.exists():
+                # Get repo path if available
+                repo_file = SERVERS_DIR / f"{hash_prefix}.repo"
+                repo_path = repo_file.read_text().strip() if repo_file.exists() else "unknown"
+
+                # Get PID if available
+                pid_file = SERVERS_DIR / f"{hash_prefix}.pid"
+                pid = pid_file.read_text().strip() if pid_file.exists() else "unknown"
+
+                # Check health
                 try:
-                    pid = pid_file.read_text().strip()
-                except IOError:
-                    pass
-
-            console.print(f"[bold green]Server running[/bold green]")
-            console.print(f"  Port: {port}")
-            console.print(f"  PID: {pid}")
-            console.print(f"  URL: http://localhost:{port}")
-        else:
-            console.print(f"[yellow]Server on port {port} not healthy[/yellow]")
-    except (httpx.RequestError, httpx.TimeoutException):
-        console.print(f"[yellow]Server on port {port} not responding[/yellow]")
+                    response = httpx.get(f"http://localhost:{port}/api/health", timeout=2.0)
+                    healthy = response.status_code == 200
+                except (httpx.RequestError, httpx.TimeoutException):
+                    healthy = False
+
+                servers_found.append({
+                    "port": port,
+                    "pid": pid,
+                    "repo": repo_path,
+                    "healthy": healthy,
+                })
+            except (ValueError, IOError):
+                pass
+
+    # Check legacy location
+    legacy_port_file = Path.home() / ".emdash" / "server.port"
+    if legacy_port_file.exists():
+        try:
+            port = int(legacy_port_file.read_text().strip())
+            legacy_pid_file = Path.home() / ".emdash" / "server.pid"
+            pid = legacy_pid_file.read_text().strip() if legacy_pid_file.exists() else "unknown"
+
+            try:
+                response = httpx.get(f"http://localhost:{port}/api/health", timeout=2.0)
+                healthy = response.status_code == 200
+            except (httpx.RequestError, httpx.TimeoutException):
+                healthy = False
+
+            servers_found.append({
+                "port": port,
+                "pid": pid,
+                "repo": "(legacy)",
+                "healthy": healthy,
+            })
+        except (ValueError, IOError):
+            pass
+
+    if not servers_found:
+        console.print("[yellow]No servers running[/yellow]")
+        return
+
+    console.print(f"[bold]Found {len(servers_found)} server(s):[/bold]\n")
+    for srv in servers_found:
+        status = "[green]healthy[/green]" if srv["healthy"] else "[red]unhealthy[/red]"
+        console.print(f"  {status}")
+        console.print(f"    Port: {srv['port']}")
+        console.print(f"    PID:  {srv['pid']}")
+        console.print(f"    Repo: {srv['repo']}")
+        console.print(f"    URL:  http://localhost:{srv['port']}")
+        console.print()

emdash_cli/commands/skills.py

@@ -41,11 +41,13 @@ def skills_list():
     table.add_column("Description")
     table.add_column("User Invocable", style="green")
     table.add_column("Tools")
+    table.add_column("Scripts", style="yellow")
 
     for skill in all_skills.values():
         invocable = "Yes (/{})".format(skill.name) if skill.user_invocable else "No"
         tools = ", ".join(skill.tools) if skill.tools else "-"
-        table.add_row(skill.name, skill.description, invocable, tools)
+        scripts = str(len(skill.scripts)) if skill.scripts else "-"
+        table.add_row(skill.name, skill.description, invocable, tools, scripts)
 
     console.print(table)
 
@@ -69,12 +71,28 @@ def skills_show(name: str):
             console.print(f"[dim]Available skills: {', '.join(available)}[/dim]")
         return
 
+    # Build scripts info
+    scripts_info = "None"
+    if skill.scripts:
+        scripts_info = "\n".join([f"  - {s.name} ({s})" for s in skill.scripts])
+
     # Show skill details
-    console.print(Panel(
+    details = (
         f"[bold]Description:[/bold] {skill.description}\n\n"
         f"[bold]User Invocable:[/bold] {'Yes (/' + skill.name + ')' if skill.user_invocable else 'No'}\n\n"
         f"[bold]Tools:[/bold] {', '.join(skill.tools) if skill.tools else 'None'}\n\n"
-        f"[bold]File:[/bold] {skill.file_path}",
+        f"[bold]Scripts:[/bold] {len(skill.scripts) if skill.scripts else 'None'}"
+    )
+
+    if skill.scripts:
+        details += "\n"
+        for script in skill.scripts:
+            details += f"\n  [yellow]{script.name}[/yellow]: {script}"
+
+    details += f"\n\n[bold]File:[/bold] {skill.file_path}"
+
+    console.print(Panel(
+        details,
         title=f"[cyan]{skill.name}[/cyan]",
         border_style="cyan",
     ))
@@ -92,14 +110,19 @@ def skills_show(name: str):
 @click.option("--description", "-d", default="", help="Skill description")
 @click.option("--user-invocable/--no-user-invocable", default=True, help="Can be invoked with /name")
 @click.option("--tools", "-t", multiple=True, help="Tools this skill needs (can specify multiple)")
-def skills_create(name: str, description: str, user_invocable: bool, tools: tuple):
+@click.option("--with-script", "-s", is_flag=True, help="Include a sample executable script")
+def skills_create(name: str, description: str, user_invocable: bool, tools: tuple, with_script: bool):
     """Create a new skill.
 
-    Creates a skill directory with SKILL.md template.
+    Creates a skill directory with SKILL.md template and optional scripts.
 
     Example:
         emdash skills create commit -d "Generate commit messages" -t execute_command -t read_file
+        emdash skills create deploy -d "Deploy application" --with-script
     """
+    import os
+    import stat
+
     # Validate name
     name = name.lower().strip()
     if len(name) > 64:
@@ -122,6 +145,20 @@ def skills_create(name: str, description: str, user_invocable: bool, tools: tupl
     tools_str = ", ".join(tools) if tools else ""
     description = description or f"Description for {name} skill"
 
+    # Add script documentation if creating with script
+    script_docs = ""
+    if with_script:
+        script_docs = """
+
+## Scripts
+
+This skill includes executable scripts that can be run by the agent:
+
+- `run.sh` - Main script for this skill. Execute it using: `bash <skill_dir>/run.sh`
+
+Scripts are self-contained bash executables. The agent will run them using the Bash tool when needed.
+"""
+
     content = f"""---
 name: {name}
 description: {description}
@@ -136,7 +173,7 @@ tools: [{tools_str}]
 ## Instructions
 
 Add your skill instructions here. These will be provided to the agent when the skill is invoked.
-
+{script_docs}
 ## Usage
 
 Describe how this skill should be used.
@@ -150,7 +187,36 @@ Provide example scenarios here.
         skill_dir.mkdir(parents=True, exist_ok=True)
         skill_file.write_text(content)
         console.print(f"[green]Created skill '{name}' at {skill_file}[/green]")
+
+        # Create sample script if requested
+        if with_script:
+            script_file = skill_dir / "run.sh"
+            script_content = f"""#!/bin/bash
+# {name} skill script
+# This script is executed by the agent when needed.
+# All scripts must be self-contained and executable.
+
+set -e
+
+echo "Running {name} skill script..."
+
+# Add your script logic here
+# Example:
+# - Check prerequisites
+# - Execute commands
+# - Output results
+
+echo "Script completed successfully."
+"""
+            script_file.write_text(script_content)
+            # Make executable
+            current_mode = script_file.stat().st_mode
+            os.chmod(script_file, current_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
+            console.print(f"[green]Created script: {script_file}[/green]")
+
         console.print(f"[dim]Edit the SKILL.md file to customize the skill instructions.[/dim]")
+        if with_script:
+            console.print(f"[dim]Edit run.sh to add your script logic.[/dim]")
     except Exception as e:
         console.print(f"[red]Error creating skill: {e}[/red]")
 

emdash_cli/design.py

@@ -0,0 +1,328 @@
+"""Emdash CLI Design System.
+
+A zen, geometric design language combining clean lines with dot-matrix textures.
+The em dash (─) is the signature element, appearing in all separators and frames.
+"""
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Logo & Branding
+# ─────────────────────────────────────────────────────────────────────────────
+
+# Large stylized logo using block characters - minimal, geometric, impactful
+LOGO_LARGE = r"""
+  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+  █                                               █
+  █   ▓█▀▀▀ █▀▄▀█ █▀▀▄ ▄▀▀▄ ▓█▀▀▀█ █  █          █
+  █   ▓█▀▀  █ ▀ █ █  █ █▀▀█ ▓▀▀▀▀█ █▀▀█ ─────    █
+  █   ▓█▄▄▄ █   █ █▄▄▀ █  █ ▓█▄▄▄█ █  █          █
+  █                                               █
+  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
+"""
+
+# Medium logo - cleaner, more readable
+LOGO_MEDIUM = r"""
+   ╭─────────────────────────────────────────╮
+   │                                         │
+   │   ███ █▄ ▄█ █▀▄ ▄▀▄ ▄▀▀ █ █ ───         │
+   │   █▄▄ █ ▀ █ █ █ █▀█ ▀▀█ █▀█             │
+   │   ███ █   █ █▄▀ █ █ ▄▄▀ █ █             │
+   │                                         │
+   ╰─────────────────────────────────────────╯
+"""
+
+# Compact logo - single line, stylized
+LOGO_COMPACT = "─── ◈ emdash ◈ ───"
+
+# Ultra-minimal logo with em dash signature
+LOGO_MINIMAL = "── emdash ──"
+
+# Braille-style logo - dot matrix aesthetic
+LOGO_DOTS = r"""
+   ⠀⣠⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣄⠀
+   ⢸⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⡇
+   ⢸⣿⠀⠀⣴⣦⠀⣾⡄⣴⣦⠀⣶⣤⡀⠀⣴⣦⠀⣶⣶⣶⠀⣾⠀⣾⠀⠀⠀⠀⠀⠀⠀⣿⡇
+   ⢸⣿⠀⠀⣿⣿⠀⣿⣿⣿⣿⠀⣿⠙⣿⠀⣿⣿⠀⠀⣿⠀⠀⣿⣀⣿⠀⠤⠤⠤⠀⠀⠀⣿⡇
+   ⢸⣿⠀⠀⠛⠛⠀⠛⠀⠀⠛⠀⠛⠛⠃⠀⠛⠙⠛⠀⠛⠛⠀⠛⠀⠛⠀⠀⠀⠀⠀⠀⠀⣿⡇
+   ⠀⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠀
+"""
+
+# Block-style large text - bold and impactful
+LOGO_BLOCK = r"""
+    ╔═══════════════════════════════════════════════╗
+    ║                                               ║
+    ║   ▓▓▓▓  ▓   ▓  ▓▓▓   ▓▓▓  ▓▓▓▓  ▓  ▓         ║
+    ║   ▓     ▓▓ ▓▓  ▓  ▓ ▓   ▓ ▓     ▓▓▓▓  ────   ║
+    ║   ▓▓▓   ▓ ▓ ▓  ▓  ▓ ▓▓▓▓▓ ▓▓▓▓  ▓  ▓         ║
+    ║   ▓     ▓   ▓  ▓  ▓ ▓   ▓    ▓  ▓  ▓         ║
+    ║   ▓▓▓▓  ▓   ▓  ▓▓▓  ▓   ▓ ▓▓▓▓  ▓  ▓         ║
+    ║                                               ║
+    ╚═══════════════════════════════════════════════╝
+"""
+
+# Clean geometric logo - the recommended default
+LOGO = r"""
+    ┌─────────────────────────────────────────────┐
+    │                                             │
+    │   ╺━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╸   │
+    │                                             │
+    │            ◈  e m d a s h  ◈               │
+    │                                             │
+    │   ╺━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╸   │
+    │                                             │
+    └─────────────────────────────────────────────┘
+"""
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Typography & Signature Elements
+# ─────────────────────────────────────────────────────────────────────────────
+
+EM_DASH = "─"
+SEPARATOR_WIDTH = 45
+SEPARATOR = EM_DASH * SEPARATOR_WIDTH
+SEPARATOR_SHORT = EM_DASH * 20
+
+
+def header(title: str, width: int = SEPARATOR_WIDTH) -> str:
+    """Create a header with em dash separators.
+
+    Example: ─── Title ─────────────────────────────
+    """
+    prefix = f"{EM_DASH * 3} {title} "
+    remaining = width - len(prefix)
+    return f"{prefix}{EM_DASH * max(0, remaining)}"
+
+
+def footer(width: int = SEPARATOR_WIDTH) -> str:
+    """Create a footer separator."""
+    return EM_DASH * width
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Dot Matrix / Stippled Elements
+# ─────────────────────────────────────────────────────────────────────────────
+
+# Spinner frames - dot matrix style, feels computational
+SPINNER_FRAMES = ["⠿", "⠷", "⠯", "⠟", "⠻", "⠽", "⠾", "⠿"]
+
+# Stippled elements
+DOT_ACTIVE = "⠿"      # Dense braille - active/processing
+DOT_WAITING = "∷"     # Stippled - waiting/idle
+DOT_BULLET = "∷"      # List bullets
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Status Indicators
+# ─────────────────────────────────────────────────────────────────────────────
+
+STATUS_ACTIVE = "▸"    # Active/selected/success
+STATUS_INACTIVE = "▹"  # Inactive/pending
+STATUS_ERROR = "■"     # Solid - errors
+STATUS_INFO = "□"      # Outline - info
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Flow & Navigation
+# ─────────────────────────────────────────────────────────────────────────────
+
+ARROW_PROMPT = "›"     # Prompt/hint indicator
+ARROW_RIGHT = "»"      # Direction/flow
+NEST_LINE = "│"        # Vertical nesting
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Progress Elements
+# ─────────────────────────────────────────────────────────────────────────────
+
+PROGRESS_FULL = "█"
+PROGRESS_PARTIAL = "▓"
+PROGRESS_EMPTY = "░"
+
+
+def progress_bar(percent: float, width: int = 20) -> str:
+    """Create a progress bar.
+
+    Example: ████████▓░░░░░░░░░░░  42%
+    """
+    filled = int(width * percent / 100)
+    partial = 1 if (percent % (100 / width)) > (50 / width) and filled < width else 0
+    empty = width - filled - partial
+
+    bar = PROGRESS_FULL * filled + PROGRESS_PARTIAL * partial + PROGRESS_EMPTY * empty
+    return f"{bar}  {percent:.0f}%"
+
+
+def step_progress(current: int, total: int, width: int = 20) -> str:
+    """Create a step progress indicator.
+
+    Example: ∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷∷  step 2 of 4
+    """
+    dots = DOT_WAITING * width
+    return f"{dots}  step {current} of {total}"
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Zen Color Palette - Red/Warm Tones
+# ─────────────────────────────────────────────────────────────────────────────
+
+class Colors:
+    """Zen color palette - warm, vibrant, red-accented."""
+
+    # Core semantic colors - warmer, more vibrant
+    PRIMARY = "#f0a0a0"      # warm rose - main accent
+    SECONDARY = "#e8d0a0"    # warm sand - secondary
+    SUCCESS = "#b8d8a8"      # fresh sage - success
+    WARNING = "#f0c878"      # warm amber - warnings
+    ERROR = "#e87878"        # vibrant coral - errors
+
+    # Text hierarchy
+    TEXT = "#f0f0f0"         # bright white
+    MUTED = "#c0a8a8"        # dusty rose - secondary text
+    DIM = "#a09090"          # warm gray - hints
+
+    # Accents
+    ACCENT = "#d0b0c0"       # mauve - highlights
+    SUBTLE = "#b8a8a8"       # warm fog - disabled
+
+
+# Rich markup shortcuts
+class Markup:
+    """Rich markup helpers for consistent styling."""
+
+    @staticmethod
+    def primary(text: str) -> str:
+        return f"[{Colors.PRIMARY}]{text}[/{Colors.PRIMARY}]"
+
+    @staticmethod
+    def success(text: str) -> str:
+        return f"[{Colors.SUCCESS}]{text}[/{Colors.SUCCESS}]"
+
+    @staticmethod
+    def warning(text: str) -> str:
+        return f"[{Colors.WARNING}]{text}[/{Colors.WARNING}]"
+
+    @staticmethod
+    def error(text: str) -> str:
+        return f"[{Colors.ERROR}]{text}[/{Colors.ERROR}]"
+
+    @staticmethod
+    def muted(text: str) -> str:
+        return f"[{Colors.MUTED}]{text}[/{Colors.MUTED}]"
+
+    @staticmethod
+    def dim(text: str) -> str:
+        return f"[{Colors.DIM}]{text}[/{Colors.DIM}]"
+
+    @staticmethod
+    def accent(text: str) -> str:
+        return f"[{Colors.ACCENT}]{text}[/{Colors.ACCENT}]"
+
+    @staticmethod
+    def bold(text: str) -> str:
+        return f"[bold]{text}[/bold]"
+
+    @staticmethod
+    def italic(text: str) -> str:
+        return f"[italic]{text}[/italic]"
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Prompt Toolkit Styles
+# ─────────────────────────────────────────────────────────────────────────────
+
+# Style dict for prompt_toolkit
+PROMPT_TOOLKIT_STYLE = {
+    # Menu items
+    "selected": f"{Colors.SUCCESS} bold",
+    "option": Colors.MUTED,
+    "option-desc": Colors.DIM,
+    "hint": f"{Colors.DIM} italic",
+
+    # Headers and frames
+    "header": f"{Colors.PRIMARY} bold",
+    "separator": Colors.DIM,
+
+    # Status
+    "success": Colors.SUCCESS,
+    "warning": Colors.WARNING,
+    "error": Colors.ERROR,
+
+    # Input
+    "prompt": f"{Colors.SUCCESS} bold",
+    "prompt-plan": f"{Colors.WARNING} bold",
+}
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# ANSI Escape Codes (for raw terminal output)
+# ─────────────────────────────────────────────────────────────────────────────
+
+class ANSI:
+    """ANSI escape codes for direct terminal output."""
+
+    RESET = "\033[0m"
+    BOLD = "\033[1m"
+    DIM = "\033[2m"
+    ITALIC = "\033[3m"
+
+    # Warm zen palette as ANSI (256-color approximations)
+    PRIMARY = "\033[38;5;217m"    # warm rose
+    SECONDARY = "\033[38;5;223m"  # warm sand
+    SUCCESS = "\033[38;5;150m"    # fresh sage
+    WARNING = "\033[38;5;221m"    # warm amber
+    ERROR = "\033[38;5;203m"      # vibrant coral
+    MUTED = "\033[38;5;181m"      # dusty rose
+    SHADOW = "\033[38;5;138m"     # warm gray
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Component Templates
+# ─────────────────────────────────────────────────────────────────────────────
+
+def frame(title: str, content: str, width: int = SEPARATOR_WIDTH) -> str:
+    """Create a framed content block.
+
+    Example:
+    ─── Title ─────────────────────────────
+
+      Content goes here
+
+    ─────────────────────────────────────────
+    """
+    lines = [
+        header(title, width),
+        "",
+        content,
+        "",
+        footer(width),
+    ]
+    return "\n".join(lines)
+
+
+def menu_hint(*hints: tuple[str, str]) -> str:
+    """Create a hint bar for menus.
+
+    Example: › y approve  n feedback  Esc cancel
+    """
+    parts = [f"{key} {action}" for key, action in hints]
+    return f"{ARROW_PROMPT} {'  '.join(parts)}"
+
+
+def bullet_list(items: list[str], indent: int = 2) -> str:
+    """Create a bulleted list with stippled bullets.
+
+    Example:
+      ∷ First item
+      ∷ Second item
+    """
+    prefix = " " * indent + DOT_BULLET + " "
+    return "\n".join(f"{prefix}{item}" for item in items)
+
+
+def nested_line(text: str, indent: int = 2) -> str:
+    """Create a nested/indented line with vertical bar.
+
+    Example:
+      │ Nested content
+    """
+    return f"{' ' * indent}{NEST_LINE} {text}"