prole/install.py

#!/usr/bin/env python3
"""
Prole Service Dependencies Installer
Desktop application for installing, deploying, and validating Prole services
"""

import tkinter as tk
from tkinter import ttk, scrolledtext, messagebox
import subprocess
import threading
import os
import sys
import webbrowser
import time
import platform
from pathlib import Path
import shlex
import socket
import signal
import shutil
import json
import configparser
import tempfile
import getpass
import uuid
import re
from datetime import datetime
import urllib.request
import urllib.parse

# Refactor: import shared helpers from the root-level installer package
from installer import config as inst_config
from installer.build import get_build_command as inst_get_build_command
from installer import deploy as inst_deploy
from installer import screen as ui

# On macOS, set the process name as early as possible so the menu bar shows 'Prole Database Installer'
if platform.system() == 'Darwin':
    try:
        from Foundation import NSProcessInfo
        NSProcessInfo.processInfo().setProcessName_("Prole Database Installer")
    except Exception:
        pass

# Get the project root directory (kept local for clarity in this legacy entry)
PROJECT_ROOT = Path(__file__).parent.absolute()

# Initialize global frames list to keep them in memory
GLOBAL_SCAN_FRAMES = []


def get_resource_path(relative_path):
    """Get absolute path to resource, works for dev and for PyInstaller."""
    try:
        # PyInstaller creates a temp folder and stores path in _MEIPASS
        base_path = Path(sys._MEIPASS)
    except AttributeError:
        # Running from source
        base_path = PROJECT_ROOT

    return base_path / relative_path


# Standard Console Theme (Light background, Dark text)
CONSOLE_BG = '#F5F5DC'  # Cream/Light background similar to our images
CONSOLE_FG = '#1d1d1f'  # Dark text
CONSOLE_INSERT = '#1d1d1f'
CONSOLE_FONT = ('Menlo', 10)
NAMESPACE_PREFIX = 'prole-'
POSTGRES_DB_NAME_MAX_LEN = 63

# Default action behavior for unattended replays
DEFAULT_ACTION_FLAGS = {
    'dependencies.auto_install_missing': True,
    'network_scan.run': True,
    'init_password.generate_ssh_key': True,
    'init_db_build.run_build': True,
    'init_cluster.start_cluster': True,
    'init_scripts.run_scripts': True,
    'init_cnpg_deploy.run_deploy': True,
    'init_cnpg_deploy.force_rollout': False,
    'kerberos_config.test_connection': False,
    'kerberos_config.init_authority': False,
    'build.run_build': False,
}


def _bool_str(val: bool) -> str:
    return 'true' if bool(val) else 'false'


def _parse_bool(val, default=False) -> bool:
    if val is None:
        return default
    s = str(val).strip().lower()
    if s in ('1', 'true', 'yes', 'y', 'on'):
        return True
    if s in ('0', 'false', 'no', 'n', 'off'):
        return False
    return default


def _expand_path(val: str | None) -> str:
    if val is None:
        return ''
    return os.path.expandvars(os.path.expanduser(str(val)))


def _resolve_supabase_home(project_root: Path) -> Path | None:
    env_home = (os.environ.get('SUPABASE_HOME') or '').strip()
    if env_home:
        try:
            candidate = Path(_expand_path(env_home))
            if candidate.is_dir():
                return candidate
        except Exception:
            pass

    candidates = [
        Path.home() / 'prole' / 'supabase',
        Path.home() / 'dev' / 'supabase',
        project_root / 'supabase',
    ]
    prole_home = (os.environ.get('PROLE_HOME') or '').strip()
    if prole_home:
        try:
            candidates.append(Path(_expand_path(prole_home)).parent / 'supabase')
        except Exception:
            pass

    for candidate in candidates:
        try:
            if candidate.is_dir():
                return candidate
        except Exception:
            continue
    return None


def _collect_images_from_files(paths: list[Path]) -> set[str]:
    images = set()
    for path in paths:
        if not path or not path.exists():
            continue
        try:
            for line in path.read_text().splitlines():
                m = re.match(r'^\s*image:\s*([^\s#]+)', line)
                if not m:
                    continue
                img = m.group(1).strip().strip('"').strip("'")
                if not img:
                    continue
                img = os.path.expandvars(img)
                if '${' in img or '}' in img or '$' in img:
                    continue
                images.add(img)
        except Exception:
            continue
    return images


def _clean_yaml_value(raw: str) -> str:
    if raw is None:
        return ''
    val = raw.strip()
    if '#' in val:
        val = val.split('#', 1)[0].strip()
    if len(val) >= 2 and ((val[0] == val[-1]) and val.startswith(("'", '"'))):
        val = val[1:-1]
    return val.strip()


def _parse_yaml_scalar_values(path: Path, keys: set[str]) -> dict:
    data = {}
    if not path.exists():
        return data
    try:
        for raw in path.read_text().splitlines():
            line = raw.strip()
            if not line or line.startswith('#') or line == '---':
                continue
            if line.startswith('- '):
                continue
            if ':' not in line:
                continue
            key, val = line.split(':', 1)
            key = key.strip()
            if key not in keys:
                continue
            clean_val = _clean_yaml_value(val)
            if clean_val:
                data[key] = clean_val
    except Exception:
        pass
    return data


def _parse_internal_a_records(path: Path) -> tuple[str, dict, dict]:
    domain = ''
    ip_map: dict[str, str] = {}
    fqdn_map: dict[str, str] = {}
    if not path.exists():
        return domain, ip_map, fqdn_map
    try:
        lines = path.read_text().splitlines()
    except Exception:
        return domain, ip_map, fqdn_map
    in_block = False
    current: dict[str, str] = {}
    records = []
    for raw in lines:
        if not in_block:
            s = raw.strip()
            if s.startswith('prole_domain:'):
                domain = _clean_yaml_value(s.split(':', 1)[1])
            if s.startswith('prole_internal_a_records:'):
                in_block = True
            continue
        if raw and not raw.startswith((' ', '\t')):
            break
        s = raw.strip()
        if not s:
            continue
        if s.startswith('- '):
            if current:
                records.append(current)
            current = {}
            s = s[2:].strip()
        if ':' in s:
            key, val = s.split(':', 1)
            key = key.strip()
            if key in ('fqdn', 'ipv4'):
                current[key] = _clean_yaml_value(val)
    if current:
        records.append(current)
    for rec in records:
        fqdn = rec.get('fqdn')
        ip = rec.get('ipv4')
        if not fqdn or not ip:
            continue
        fqdn_map[fqdn] = ip
        ip_map[fqdn] = ip
        short = fqdn.split('.')[0]
        if short and short not in ip_map:
            ip_map[short] = ip
    return domain, ip_map, fqdn_map


def _parse_ansible_inventory_hosts(path: Path) -> dict:
    groups: dict[str, list[str]] = {}
    if not path.exists():
        return groups
    try:
        current_group = None
        for raw in path.read_text().splitlines():
            line = raw.strip()
            if not line or line.startswith(('#', ';')):
                continue
            if line.startswith('[') and line.endswith(']'):
                current_group = line[1:-1].strip()
                groups.setdefault(current_group, [])
                continue
            if current_group is None:
                continue
            host = line.split()[0]
            if host and host not in groups[current_group]:
                groups[current_group].append(host)
    except Exception:
        pass
    return groups


def _resolve_host_ip(host: str, domain: str, ip_map: dict) -> str:
    if not host:
        return ''
    if host in ip_map:
        return ip_map[host]
    if domain:
        if '.' not in host:
            fqdn = f"{host}.{domain}"
            if fqdn in ip_map:
                return ip_map[fqdn]
        else:
            short = host.split('.')[0]
            if short in ip_map:
                return ip_map[short]
    return ''


def _detect_ansible_topology(project_root: Path) -> dict:
    prole_home = (os.environ.get('PROLE_HOME') or '').strip()
    base_candidates = []
    if prole_home:
        base_candidates.append(Path(_expand_path(prole_home)))
    base_candidates.append(project_root)
    infra_path = None
    for base in base_candidates:
        try:
            candidate = base / 'infrastructure'
            if candidate.is_dir():
                infra_path = candidate
                break
        except Exception:
            continue
    if infra_path is None:
        return {}
    inventory_path = infra_path / 'inventory'
    if not inventory_path.is_dir():
        return {}
    groups = _parse_ansible_inventory_hosts(inventory_path / 'hosts.ini')
    vars_vals = _parse_yaml_scalar_values(
        inventory_path / 'group_vars' / 'all' / 'vars.yml',
        {'ad_dc_ip', 'prole_domain', 'kerberos_realm', 'krb5_realm', 'kerberos_kdc', 'krb5_kdc', 'kerberos_kdc_ip'}
    )
    domain = vars_vals.get('prole_domain', '')
    ad_dc_ip = vars_vals.get('ad_dc_ip', '')
    explicit_realm = vars_vals.get('kerberos_realm') or vars_vals.get('krb5_realm') or ''
    explicit_kdc = vars_vals.get('kerberos_kdc') or vars_vals.get('krb5_kdc') or vars_vals.get('kerberos_kdc_ip') or ''
    if explicit_kdc and not ad_dc_ip:
        ad_dc_ip = explicit_kdc
    dns_domain, ip_map, fqdn_records = _parse_internal_a_records(inventory_path / 'group_vars' / 'all' / 'dns.yml')
    if not domain and dns_domain:
        domain = dns_domain
    ad_vars = _parse_yaml_scalar_values(
        inventory_path / 'group_vars' / 'ad_dc' / 'vars.yml',
        {'samba_dns_server'}
    )
    samba_dns_server = ad_vars.get('samba_dns_server', '')
    ad_dc_host = ''
    ad_dc_hosts = groups.get('ad_dc') or []
    if ad_dc_hosts:
        ad_dc_host = ad_dc_hosts[0]
    if samba_dns_server:
        ad_dc_host = ad_dc_host or samba_dns_server
        if not ad_dc_ip:
            ad_dc_ip = _resolve_host_ip(samba_dns_server, domain, ip_map)
    if not ad_dc_ip and ad_dc_host:
        ad_dc_ip = _resolve_host_ip(ad_dc_host, domain, ip_map)
    kdc_ip = explicit_kdc or ad_dc_ip or ''
    realm = explicit_realm or (domain.upper() if domain else '')

    all_hosts = set()
    for hosts in groups.values():
        all_hosts.update(hosts)
    if ad_dc_host:
        all_hosts.add(ad_dc_host)
    host_ip_map = {}
    unmapped_hosts = []
    for host in sorted(all_hosts):
        ip = _resolve_host_ip(host, domain, ip_map)
        if ip:
            host_ip_map[host] = ip
        else:
            unmapped_hosts.append(host)

    topology = {
        'domain': domain,
        'realm': realm,
        'internal_records': fqdn_records,
        'ad_dc': {
            'host': ad_dc_host,
            'ip': ad_dc_ip,
        },
        'groups': groups,
        'hosts': host_ip_map,
        'unmapped_hosts': unmapped_hosts,
    }
    try:
        topology_json = json.dumps(topology, separators=(',', ':'))
    except Exception:
        topology_json = ''
    return {
        'infrastructure_path': str(infra_path),
        'inventory_path': str(inventory_path),
        'domain': domain,
        'realm': realm,
        'ad_dc_ip': ad_dc_ip,
        'ad_dc_host': ad_dc_host,
        'kdc_ip': kdc_ip,
        'groups': groups,
        'hosts': host_ip_map,
        'unmapped_hosts': unmapped_hosts,
        'topology': topology,
        'topology_json': topology_json,
    }


def _format_ansible_topology_summary(info: dict) -> str:
    if not info:
        return ''
    lines = []
    inv = info.get('inventory_path') or ''
    if inv:
        lines.append(f"Ansible inventory detected at {inv}.")
    domain = info.get('domain') or ''
    realm = info.get('realm') or ''
    if domain or realm:
        if domain and realm:
            lines.append(f"Domain: {domain} (Realm: {realm})")
        elif domain:
            lines.append(f"Domain: {domain}")
        else:
            lines.append(f"Realm: {realm}")
    ad_dc_host = info.get('ad_dc_host') or ''
    ad_dc_ip = info.get('ad_dc_ip') or ''
    if ad_dc_host or ad_dc_ip:
        if ad_dc_host and ad_dc_ip:
            lines.append(f"AD DC: {ad_dc_host} -> {ad_dc_ip}")
        elif ad_dc_ip:
            lines.append(f"AD DC IP: {ad_dc_ip}")
        else:
            lines.append(f"AD DC Host: {ad_dc_host}")
    groups = info.get('groups') or {}
    if groups:
        group_bits = []
        for name in sorted(groups.keys()):
            group_bits.append(f"{name}({len(groups[name])})")
        lines.append("Groups: " + ", ".join(group_bits))
    hosts = info.get('hosts') or {}
    if hosts:
        host_items = sorted(hosts.items())
        preview = host_items[:8]
        host_str = ", ".join([f"{h}={ip}" for h, ip in preview])
        if len(host_items) > len(preview):
            host_str += f", +{len(host_items) - len(preview)} more"
        lines.append("Hosts: " + host_str)
    unmapped = info.get('unmapped_hosts') or []
    if unmapped:
        lines.append(f"Hosts without IPs: {len(unmapped)}")
    return "\n".join(lines)


def _render_prole_cfg(inputs: dict, globals_to_save: dict, sections: dict, generated_at: str | None = None) -> str:
    content = []
    content.append('; Prole Master Configuration File')
    content.append('; Generated by install.py on ' + (generated_at or time.strftime('%Y-%m-%d %H:%M:%S')))
    content.append('; This file is used as input for Ansible deployment and k8s cluster creation.')
    content.append('')

    # Inputs section (replayable UI inputs)
    content.append('[Inputs]')
    content.append('; Screen-scoped inputs used for unattended replays (-S)')
    if not inputs:
        content.append('; No input values captured yet for this section.')
    else:
        for k in sorted(inputs.keys()):
            content.append(f'{k} = {inputs[k]}')
    content.append('')

    # Global Section
    content.append('[Global]')
    content.append('; Variables used by name in more than one place or assumed global scope')
    for k, v in sorted(globals_to_save.items()):
        content.append(f'{k} = {v}')
    content.append('')

    sections_order = [
        'Welcome', 'Dependencies', 'Network', 'System Environment',
        'Monitoring', 'Kerberos Authentication', 'Optional Features', 'Database Creation',
        'Initialize Cluster', 'Docker Build', 'Initialization Scripts',
        'Prole DB Deploy', 'Install'
    ]

    for section in sections_order:
        data = sections.get(section, {})
        content.append(f'[{section}]')
        if not data:
            content.append('; No configuration values captured yet for this section.')
        else:
            for k, v in sorted(data.items()):
                content.append(f'{k} = {v}')
        content.append('')
    return '\n'.join(content)

class ProleController:
    """Business logic for Prole installer, separated from UI."""
    def __init__(self, project_root):
        self.project_root = project_root

    def check_docker_running(self):
        """Check if Docker daemon is responsive."""
        try:
            subprocess.run(['docker', 'info'], capture_output=True, check=True)
            return True
        except (subprocess.CalledProcessError, FileNotFoundError):
            return False

    def get_prole_db_version(self):
        pg_version_file = self.project_root / "conf" / "postgresql" / ".version"
        release_file = self.project_root / "prole-db" / ".version"
        pg_version = pg_version_file.read_text().strip() if pg_version_file.exists() else "17.7"
        release = release_file.read_text().strip() if release_file.exists() else "43"
        if release.isdigit():
            release = release.zfill(3)
        return f"{pg_version}-{release}"

    def run_script(self, script_name, args=None, env=None, stdin_text=None, on_line=None, on_stderr_line=None, stderr_to_stdout=True):
        """Generic runner for etc/ scripts.
        Copies the script to $PROLE_HOME/etc before running it.
        """
        if args is None: args = []
        
        # Get paths
        source_script = self.project_root / "etc" / script_name
        
        # Determine target etc directory
        prole_home_val = (env or os.environ).get("PROLE_HOME")
        if not prole_home_val:
            prole_home = Path.home() / ".prole"
        else:
            prole_home = Path(prole_home_val).expanduser()
            
        target_etc = prole_home / "etc"
        target_etc.mkdir(parents=True, exist_ok=True)
        target_script = target_etc / script_name
        
        # Also ensure k8s resources are copied to $PROLE_HOME/k8s for reference
        target_k8s = prole_home / "k8s"
        source_k8s = self.project_root / "k8s"
        if source_k8s.exists():
            if source_k8s.resolve() != target_k8s.resolve():
                if not target_k8s.exists() or (source_k8s.stat().st_mtime > target_k8s.stat().st_mtime):
                    if target_k8s.exists():
                        shutil.rmtree(target_k8s)
                    shutil.copytree(source_k8s, target_k8s)

        # Ensure conf/postgresql is copied for version detection
        target_conf = prole_home / "conf"
        source_conf = self.project_root / "conf"
        if source_conf.exists():
            if source_conf.resolve() != target_conf.resolve():
                if not target_conf.exists() or (source_conf.stat().st_mtime > target_conf.stat().st_mtime):
                    # Only copy what we need or the whole thing? etc/ already exists in PROLE_HOME.
                    # Let's copy the whole conf dir if it doesn't exist or is older.
                    if target_conf.exists():
                        shutil.rmtree(target_conf)
                    shutil.copytree(source_conf, target_conf)

        # Ensure prole-db/.version is available in PROLE_HOME for image tagging
        source_db_version = self.project_root / "prole-db" / ".version"
        if source_db_version.exists():
            target_db_dir = prole_home / "prole-db"
            target_db_dir.mkdir(parents=True, exist_ok=True)
            target_db_version = target_db_dir / ".version"
            try:
                shutil.copy2(source_db_version, target_db_version)
            except Exception:
                pass

        # Copy script and set permissions
        if source_script.exists():
            if source_script.resolve() != target_script.resolve():
                shutil.copy2(source_script, target_script)
            os.chmod(target_script, 0o755)

        # Keep shared config helpers in sync (prole_cfg.sh)
        try:
            source_cfg = self.project_root / "etc" / "prole_cfg.sh"
            target_cfg = target_etc / "prole_cfg.sh"
            if source_cfg.exists():
                if not target_cfg.exists() or (source_cfg.stat().st_mtime > target_cfg.stat().st_mtime):
                    shutil.copy2(source_cfg, target_cfg)
                    os.chmod(target_cfg, 0o755)
        except Exception:
            pass
        
        # Run from the installed location
        cmd = ['bash', str(target_script)] + args
        
        # Ensure PYTHONUNBUFFERED=1 for any python scripts called within the bash script
        run_env = (env or os.environ).copy()
        run_env['PYTHONUNBUFFERED'] = '1'
        
        proc = subprocess.Popen(
            cmd,
            stdin=subprocess.PIPE if stdin_text else None,
            stdout=subprocess.PIPE,
            stderr=subprocess.STDOUT if stderr_to_stdout else subprocess.PIPE,
            text=True,
            bufsize=1,
            env=run_env
        )
        
        if stdin_text and proc.stdin:
            proc.stdin.write(stdin_text)
            proc.stdin.close()
            
        def _read_stream(stream, handler):
            if not stream:
                return
            for line in iter(stream.readline, ''):
                if handler:
                    handler(line)

        stderr_thread = None
        if not stderr_to_stdout:
            stderr_thread = threading.Thread(target=_read_stream, args=(proc.stderr, on_stderr_line), daemon=True)
            stderr_thread.start()

        while True:
            line = proc.stdout.readline() if proc.stdout else None
            if not line and proc.poll() is not None:
                break
            if line and on_line:
                on_line(line)
        if stderr_thread:
            stderr_thread.join(timeout=2)
        
        return proc.returncode


def is_apple_silicon():
    """Check if running on Apple Silicon (ARM64)."""
    return inst_config.is_apple_silicon()


def get_docker_build_platform_args():
    """Get Docker build platform arguments for Apple Silicon (from config)."""
    return inst_config.get_docker_build_platform_args()


class ProleInstaller:
    KUBECTL_STATUS_TAB = "__kubectl_status__"
    def __init__(self, root, config_path: str | None = None):
        self.controller = ProleController(PROJECT_ROOT)
        self.screens = None
        self.deploy_environment = None
        self.root = root
        self._installing_dep_id = None
        self._cfg_path_override = Path(config_path).expanduser() if config_path else None
        self._action_flags = {}
        self.root.title("Prole Database Installer")
        # Best-effort: set app identity (menu title / dock icon) early
        try:
            self._set_app_identity()
        except Exception:
            pass
        
        # Center window on screen
        window_width = 1300
        window_height = 910
        screen_width = root.winfo_screenwidth()
        screen_height = root.winfo_screenheight()
        center_x = int(screen_width / 2 - window_width / 2)
        center_y = int(screen_height / 2 - window_height / 2)
        self.root.geometry(f"{window_width}x{window_height}+{center_x}+{center_y}")
        self.root.resizable(False, False)

        # Force light mode colors and prevent dark mode shifts
        self.root.configure(bg='white')
        
        # Style configuration
        self.style = ttk.Style()
        self.configure_styles()
        
        # Main container with two columns
        self.main_container = tk.Frame(root, bg='white')
        self.main_container.pack(fill='both', expand=True)

        # Left Sidebar (approx 25%)
        self.sidebar = tk.Frame(self.main_container, bg='#F5F5DC', width=325) # Sepia background
        self.sidebar.pack(side='left', fill='y')
        self.sidebar.pack_propagate(False)

        # Vertical Divider Line
        self.divider = tk.Frame(self.main_container, bg='#CCCCCC', width=1, highlightthickness=0, bd=0)
        self.divider.pack(side='left', fill='y')

        # Right Content Area (approx 66%)
        self.content_area = tk.Frame(self.main_container, bg='white')
        self.content_area.pack(side='left', fill='both', expand=True)

        # Footer for Next/Prev buttons in the content area
        btns = ui.create_nav_footer(
            self.content_area,
            buttons=[(1, 'Previous'), (2, 'Next'), (3, 'Deploy'), (4, 'Launch')],
            commands={1: self.on_prev, 2: self.on_next, 3: self.on_deploy, 4: self.on_launch},
            style_name='Nav.TButton',
        )
        self.footer = btns.get('_footer')  # type: ignore[assignment]
        self.prev_button = btns.get(1)
        self.next_button = btns.get(2)
        self.deploy_button = btns.get(3)
        self.launch_button = btns.get(4)

        # Background canvas for the content area
        self._bg_pil = None
        self._bg_tk = None
        self.bg_canvas = tk.Canvas(self.content_area, highlightthickness=0, bd=0, bg='white')
        self.bg_canvas.pack(fill='both', expand=True)
        self._bg_item = None

        # Slide area: a container for overlaying widgets on the canvas.
        # We use a frame. On macOS, we can't make it truly transparent without lifting/lowering.
        self.slide_area = tk.Frame(self.bg_canvas, bg='white')
        # We will use place but manage visibility in show_page
        self.slide_area.place(relx=0, rely=0, relwidth=1, relheight=1)
        self.slide_area.lower() # Start below canvas items
        
        try:
            from PIL import Image, ImageTk
            bg_path = get_resource_path('img/proleLogoSepia.png')
            if bg_path.exists():
                # Load and prepare image with 50% opacity
                original = Image.open(str(bg_path)).convert('RGBA')
                # Create a white background of the same size
                white_bg = Image.new('RGBA', original.size, (255, 255, 255, 255))
                # Blend with 15% opacity of original (85% white)
                self._bg_pil = Image.blend(white_bg, original, 0.15)

                def _render_bg(event=None):
                    if not self._bg_pil: return
                    cw = max(1, self.bg_canvas.winfo_width())
                    ch = max(1, self.bg_canvas.winfo_height())
                    iw, ih = self._bg_pil.size
                    scale = max(cw / iw, ch / ih)
                    nw, nh = max(1, int(iw * scale)), max(1, int(ih * scale))
                    img = self._bg_pil.resize((nw, nh), Image.LANCZOS)
                    self._bg_tk = ImageTk.PhotoImage(img)
                    if self._bg_item is not None:
                        self.bg_canvas.delete(self._bg_item)
                    self._bg_item = self.bg_canvas.create_image(cw // 2, ch // 2, image=self._bg_tk, anchor='center')
                    self.bg_canvas.tag_lower(self._bg_item)

                self.bg_canvas.bind('<Configure>', _render_bg)
        except Exception as e:
            print(f"Error loading background: {e}")

        # Navigation menu items
        self.nav_items = [
            ("Welcome", "welcome"),
            ("Dependencies", "deps_summary"),
            ("Network", "network_scan"),
            ("System Environment", "env_setup"),
            ("Database Creation", "init_password"),
            ("Start Cluster", "init_cluster"),
            ("Docker Build", "init_db_build"),
            ("Initialization Scripts", "init_scripts"),
            ("Kerberos Authentication", "kerberos_config"),
            ("Supabase", "supabase_config"),
            ("Prole DB Deploy", "init_cnpg_deploy"),
            ("Install", "create_installer")
        ]
        self.nav_widgets = {}
        self._create_sidebar_nav()
        
        # Initialize validation attributes before creating screens
        self.validation_running = False
        self.validation_thread = None
        # Welcome/splash dependency scan state
        self._welcome_scan_started = False
        self.splash_scan_running = False
        self.splash_scan_done_at = None
        self.splash_scan_started_at = None
        self._splash_status_item = None
        # Capture expected host (short hostname) at app start for safety guards
        try:
            self.expected_host = (platform.node() or socket.gethostname()).split('.')[0]
        except Exception:
            self.expected_host = None
        
        # Content will be rendered directly on the background canvas to avoid
        # any opaque rectangles obscuring the image.
        self._canvas_page = None
        self._canvas_items = []
        self.canvas_renderers = {}
        # Keep track of small overlay widgets placed above the canvas so we can
        # cleanly remove them on page switches (e.g., radiobuttons, consoles)
        self._overlay_widgets = []
        # Cursor blink timer id for command preview
        self._cursor_blink_after_id = None
        self._cursor_blink_visible = False

        # Shared dependency catalog from installer.config
        self.dependencies = list(inst_config.DEPENDENCIES)

        # Initialize prole.cfg data structure
        self.prole_cfg_data = {
            'Global': {},
            'Welcome': {},
            'Dependencies': {},
            'Network': {},
            'System Environment': {},
            'Kerberos Authentication': {},
            'Optional Features': {},
            'Database Creation': {},
            'Docker Build': {},
            'Initialize Cluster': {},
            'Initialization Scripts': {},
            'Prole DB Deploy': {},
            'Install': {}
        }

        # Disk selection variables
        self.selected_disk_type = tk.StringVar(value='local') # 'removable' or 'local'
        self.selected_removable_disk = tk.StringVar()
        self.selected_local_path = tk.StringVar(value=str(Path.home()))
        self.removable_disks = [] # List of (name, mount_point)

        # Wizard pages setup
        self.pages = []  # list of (page_id, frame)
        self.page_index = 0

        # Initialize variables for new Initialize screens
        self.cluster_env = tk.StringVar(value='dev')
        try:
            self.db_username = tk.StringVar(value=os.getlogin())
        except Exception:
            self.db_username = tk.StringVar(value="prole")
        self.db_password = tk.StringVar()
        self.db_password_confirm = tk.StringVar()
        self.namespace_owner = self._get_local_owner()
        self.db_namespace = tk.StringVar(value=self._initial_namespace())
        self.db_host_port = tk.StringVar(value='5432')
        self.db_namespace_suffix = tk.StringVar()
        self._updating_namespace_fields = False
        self._sync_namespace_suffix_from_full()
        self.db_namespace.trace_add('write', lambda *args: self._sync_namespace_suffix_from_full())
        self.db_namespace_suffix.trace_add('write', lambda *args: self._sync_namespace_full_from_suffix())

        # Kerberos variables
        self.kerberos_enabled = tk.BooleanVar(value=False)
        self.kerberos_realm = tk.StringVar()
        self.kerberos_user = tk.StringVar()
        self.kerberos_password = tk.StringVar()
        self.kerberos_kdc = tk.StringVar()
        self.supabase_enabled = tk.BooleanVar(value=False)
        self.at_rest_encryption_enabled = tk.BooleanVar(value=True)
        self.ansible_topology = {}
        self.ansible_topology_summary = ''
        try:
            self._apply_ansible_topology_defaults()
        except Exception:
            pass

        # Create pages
        self.page_frames = {}
        self.verify_mode = tk.BooleanVar(value=False)
        # Register page ids (renderers will draw directly on canvas)
        self._register_canvas_renderer('welcome', self._render_welcome_page)
        self._register_canvas_renderer('network_scan', self._render_network_scan_page)
        self._register_canvas_renderer('env_setup', self._render_env_setup_page)
        self._register_canvas_renderer('deps_summary', self._render_deps_summary_page)
        for dep in self.dependencies:
            self._register_canvas_renderer(f"dep_{dep['id']}", lambda d=dep: self._render_dependency_page(d))
        
        self._register_canvas_renderer('kerberos_config', self._render_kerberos_config_page)
        self._register_canvas_renderer('supabase_config', self._render_supabase_config_page)

        # New Initialize screens
        self._register_canvas_renderer('init_cluster', self._render_init_cluster_page)
        self._register_canvas_renderer('init_db_build', self._render_init_db_build_page)
        self._register_canvas_renderer('init_password', self._render_init_password_page)
        self._register_canvas_renderer('init_cnpg_deploy', self._render_init_cnpg_deploy_page)
        self._register_canvas_renderer('init_scripts', self._render_init_scripts_page)

        self._register_canvas_renderer('build', self._render_build_page)
        self._register_canvas_renderer('disk_selection', self._render_disk_selection_page)
        self._register_canvas_renderer('build_summary', self._render_build_summary_page)
        self._register_canvas_renderer('create_installer', self._render_create_installer_page)

        # Mirror old pages list ordering for navigation
        self._register_page('welcome', None)
        self._register_page('deps_summary', None)
        self._register_page('network_scan', None)
        self._register_page('env_setup', None)
        self._register_page('init_password', None)
        self._register_page('init_cluster', None)
        self._register_page('init_db_build', None)
        self._register_page('init_scripts', None)
        self._register_page('kerberos_config', None)
        self._register_page('supabase_config', None)
        
        # New Initialize screens in sequence
        self._register_page('init_cnpg_deploy', None)
        self._register_page('create_installer', None)

        # Initial render after window shows
        self.root.after(100, lambda: self.selected_local_path.set(str(self._get_prole_dist_dir())))
        self.update_footer()
        self.show_page(0)
        
    # ---------------- App identity (title, Dock icon) ----------------
    def _set_app_identity(self):
        """Set the installer identity: process/menu name and Dock icon on macOS.

        Notes:
        - We set Tk's appname for consistency.
        - On macOS, attempt to set the process/menu name to 'Prole Database Installer'
          via NSProcessInfo if PyObjC is available.
        - Prefer the Prole Tools.app .icns from the built app; fallback to local PNG/GIF.
        """
        # Set Tk application name
        try:
            self.root.tk.call('tk', 'appname', 'Prole Database Installer')
        except Exception:
            pass

        # macOS: set process/menu name and Dock icon via AppKit/Foundation
        if platform.system() == 'Darwin':
            # Try to set the visible process name for the menu bar
            try:
                from Foundation import NSProcessInfo
                NSProcessInfo.processInfo().setProcessName_("Prole Database Installer")
            except Exception:
                pass

            # Also try to retitle the first main menu item so the menu next to the Apple logo reads 'Prole Database Installer'
            try:
                from AppKit import NSApplication
                app = NSApplication.sharedApplication()
                main_menu = app.mainMenu()
                if main_menu is not None and main_menu.numberOfItems() > 0:
                    first_item = main_menu.itemAtIndex_(0)
                    if first_item is not None:
                        first_item.setTitle_("Prole Database Installer")
            except Exception:
                pass

            icns_candidates = [
                get_resource_path('prole-app/dist/Prole Tools.app/Contents/Resources/Prole Tools.icns'),
                get_resource_path('prole-app/dist/Prole Tools.app/Contents/Resources/Prole.icns'),
            ]
            icns_path = next((p for p in icns_candidates if p.exists()), None)
            if icns_path is not None:
                try:
                    # Use PyObjC if available
                    from AppKit import NSApplication, NSImage
                    img = NSImage.alloc().initWithContentsOfFile_(str(icns_path))
                    if img is not None:
                        NSApplication.sharedApplication().setApplicationIconImage_(img)
                        return
                except Exception:
                    pass

            # If no .icns was found, try setting Dock icon from configured PNG
            try:
                from AppKit import NSApplication, NSImage
                cfg_icon = inst_config.get_ui_icon_image_path()
                if cfg_icon.exists():
                    png_img = NSImage.alloc().initWithContentsOfFile_(str(cfg_icon))
                    if png_img is not None:
                        NSApplication.sharedApplication().setApplicationIconImage_(png_img)
                        # do not return; still set Tk icon below for consistency
            except Exception:
                pass

        # Fallback: Tk icon from image assets (PNG/GIF)
        # Prefer config-defined icon image
        try:
            cfg_icon = inst_config.get_ui_icon_image_path()
        except Exception:
            cfg_icon = get_resource_path('img/proleIcon.png')
        img_candidates = [
            cfg_icon,
            get_resource_path('img/prole-type.png'),
            get_resource_path('img/prole-type.gif'),
            get_resource_path('img/Prole.png'),
            get_resource_path('img/proleLogoSepia.png'),
        ]
        for p in img_candidates:
            try:
                if p.exists():
                    self._app_iconphoto = tk.PhotoImage(file=str(p))
                    try:
                        self.root.iconphoto(True, self._app_iconphoto)
                    except Exception:
                        pass
                    break
            except Exception:
                continue
        
    def configure_styles(self):
        """Configure ttk styles"""
        base_bg = 'white'
        self.style.configure('TFrame', background='white')
        self.style.configure('TLabel', background='white', foreground='black', font=('SF Pro Text', 11))
        self.style.configure('Header.TLabel', font=('SF Pro Text', 16, 'bold'))
        self.style.configure('Small.TLabel', font=('SF Pro Text', 10))
        
        # Consistent button styling
        self.style.configure('Nav.TButton', 
                            font=('SF Pro Text', 11), 
                            padding=(12, 8),
                            background='#F5F5DC',
                            bordercolor='#F5F5DC',
                            lightcolor='#F5F5DC',
                            darkcolor='#F5F5DC',
                            relief='flat')
        
        # Map state colors to avoid black boxes on hover/active
        self.style.map('Nav.TButton',
                      background=[('active', '#E5E5D5'), ('pressed', '#D5D5C5')],
                      bordercolor=[('active', '#E5E5D5'), ('pressed', '#D5D5C5')],
                      lightcolor=[('active', '#E5E5D5'), ('pressed', '#D5D5C5')],
                      darkcolor=[('active', '#E5E5D5'), ('pressed', '#D5D5C5')])

        # Notebook styling to match light theme and avoid dark mode shifts on macOS
        self.style.theme_use('default')
        self.style.configure('TNotebook', background='white', borderwidth=0, highlightthickness=0)
        self.style.configure('TNotebook.Tab', 
                            background='#F5F5DC', 
                            foreground='black', 
                            lightcolor='#F5F5DC', 
                            bordercolor='#CCCCCC',
                            darkcolor='#F5F5DC',
                            borderwidth=1,
                            padding=[10, 5])
        self.style.map('TNotebook.Tab',
                      background=[('selected', 'white')],
                      bordercolor=[('selected', '#CCCCCC')],
                      lightcolor=[('selected', 'white')],
                      focuscolor=[('selected', 'white')])
        
        # Ensure common controls inherit white background
        try:
            self.style.configure('TCheckbutton', background=base_bg, foreground='black')
            self.style.configure('TCombobox', fieldbackground='white', background=base_bg)
        except Exception:
            pass

    def _apply_ansible_topology_defaults(self):
        info = _detect_ansible_topology(PROJECT_ROOT)
        if not info:
            return
        self.ansible_topology = info
        self.ansible_topology_summary = _format_ansible_topology_summary(info)
        try:
            net = self.prole_cfg_data.get('Network', {})
            if info.get('topology_json'):
                net['ANSIBLE_TOPOLOGY'] = info['topology_json']
            if info.get('inventory_path'):
                net['ANSIBLE_INVENTORY'] = info['inventory_path']
            if info.get('infrastructure_path'):
                net['ANSIBLE_INFRASTRUCTURE'] = info['infrastructure_path']
            if info.get('domain'):
                net['ANSIBLE_DOMAIN'] = info['domain']
            if info.get('realm'):
                net['ANSIBLE_REALM'] = info['realm']
            if info.get('ad_dc_host'):
                net['AD_DC_HOST'] = info['ad_dc_host']
            if info.get('ad_dc_ip'):
                net['AD_DC_IP'] = info['ad_dc_ip']
            if info.get('kdc_ip'):
                net['KDC_ANSIBLE_DETECTED'] = info['kdc_ip']
            self.prole_cfg_data['Network'] = net
        except Exception:
            pass

        try:
            if not self.kerberos_kdc.get().strip() and info.get('kdc_ip'):
                self.kerberos_kdc.set(info['kdc_ip'])
                self.kerberos_enabled.set(True)
            if not self.kerberos_realm.get().strip() and info.get('realm'):
                self.kerberos_realm.set(info['realm'])
        except Exception:
            pass

    def _create_sidebar_nav(self):
        """Create the left-hand navigation menu."""
        tk.Label(self.sidebar, text="INSTALLER", bg='#F5F5DC', fg='#8B8B7A', 
                 font=('SF Pro Text', 10, 'bold'), anchor='w').pack(fill='x', padx=20, pady=(20, 10))
        
        for text, page_id in self.nav_items:
            lbl = tk.Label(self.sidebar, text=text, bg='#F5F5DC', fg='black',
                          font=('SF Pro Text', 11), anchor='w', padx=20, pady=5, cursor='hand2')
            lbl.pack(fill='x')
            lbl.bind('<Button-1>', lambda e, p=page_id: self.show_page(p))
            self.nav_widgets[page_id] = lbl

    def _update_nav_highlight(self, active_id):
        """Highlight the current active page in the sidebar."""
        # Handle dep_id mapping to 'Dependencies'
        if active_id.startswith('dep_'):
            active_id = 'deps_summary'

        for page_id, widget in self.nav_widgets.items():
            if page_id == active_id:
                widget.configure(bg='#E5E5D5', font=('SF Pro Text', 11, 'bold'))
            else:
                widget.configure(bg='#F5F5DC', font=('SF Pro Text', 11))

    def create_navigation(self):
        pass

    def show_screen(self, screen_id):
        self.show_page(screen_id)

    def show_page(self, index_or_id):
        # Resolve index and page_id
        old_idx = self.page_index
        if isinstance(index_or_id, int):
            idx = max(0, min(index_or_id, len(self.pages) - 1))
        else:
            # Find index by page_id
            idx = -1
            for i, (pid, _) in enumerate(self.pages):
                if pid == index_or_id:
                    idx = i
                    break
            
            if idx == -1:
                msg = f"Navigation error: page ID '{index_or_id}' not found."
                print(f"[ERROR] {msg}")
                try:
                    messagebox.showerror("Navigation Error", msg)
                except Exception:
                    pass
                return
        
        print(f"[DEBUG] Navigating from {old_idx} to {idx} (requested: {index_or_id})")
        self.page_index = idx
        pid, frame = self.pages[self.page_index]

        # Clear any previously drawn canvas content
        self._clear_canvas_page()
        self._update_nav_highlight(pid)

        # If the page has overlay widgets, we need to show the slide_area.
        # Otherwise, we hide it so the canvas content is visible.
        # Pages that use canvas drawing and need to show the background should have slide_area hidden.
        canvas_only_pages = (
            'welcome', 'network_scan', 'env_setup', 'kerberos_config',
            'deps_summary', 'init_cluster', 'init_password', 'init_db_build',
            'init_cnpg_deploy', 'init_scripts', 'build', 'build_summary'
        )
        if pid in canvas_only_pages or pid.startswith('dep_'):
            self.slide_area.place_forget()
        else:
            self.slide_area.place(relx=0, rely=0, relwidth=1, relheight=1)
            self.slide_area.lift()
        
        # Render the page directly on the canvas if we have a renderer
        if pid in self.canvas_renderers:
            try:
                self.canvas_renderers[pid]()
            except Exception as e:
                # Fallback: show an error message on canvas
                ui.canvas_text(self, 32, 32, f"Error rendering page '{pid}': {e}", fill='black', font=('SF Pro Text', 11))
        elif frame is not None:
            # Legacy fallback (should not be used)
            frame.place(relx=0.5, rely=0.5, anchor='center', relwidth=0.94, relheight=0.9)
        self.update_footer()

    # ---------------- Canvas page rendering ----------------
    def _register_canvas_renderer(self, page_id, func):
        self.canvas_renderers[page_id] = func

    def _register_page(self, page_id, frame):
        self.pages.append((page_id, frame))
        self.page_frames[page_id] = frame

    def _clear_canvas_page(self):
        # Unbind common events to prevent "echo" or persistent behavior from previous pages
        try:
            self.bg_canvas.unbind('<Button-1>')
            self.root.unbind('<Return>')
            self.root.unbind('<KP_Enter>')
        except Exception:
            pass

        # Reset slide_area background to white for safety
        try:
            self.slide_area.configure(bg='white')
        except Exception:
            pass
            
        # Remove any small overlay widgets from the previous page
        try:
            if getattr(self, '_overlay_widgets', None):
                for w in list(self._overlay_widgets):
                    try:
                        w.destroy()
                    except Exception:
                        try:
                            w.place_forget()
                        except Exception:
                            pass
                self._overlay_widgets.clear()
        except Exception:
            pass

        # Clear page-specific canvas drawings (keep the background image)
        if self._canvas_items:
            for item in self._canvas_items:
                try:
                    self.bg_canvas.delete(item)
                except Exception:
                    pass
            self._canvas_items.clear()

    # ---------------- Environment setup helpers ----------------
    def resolve_prole_home(self) -> Path:
        """Return PROLE_HOME or default to $HOME/.prole as a Path (expanded)."""
        val = os.environ.get('PROLE_HOME')
        if val:
            try:
                return Path(val).expanduser()
            except Exception:
                pass
        return Path.home() / '.prole'

    def ensure_prole_env(self) -> Path:
        """Ensure $PROLE_HOME and env.sh exist and are readable. Create minimal env if missing.

        Returns the resolved PROLE_HOME Path. Raises Exception on failure.
        """
        home = self.resolve_prole_home()
        try:
            home.mkdir(parents=True, exist_ok=True)
        except Exception as e:
            raise Exception(f"Failed to create PROLE_HOME at {home}: {e}")
        env_file = home / 'env.sh'
        if not env_file.exists():
            # Construct minimal values based on defaults with this home
            vals = {
                'PROLE_HOME': str(home),
                'PROLE_CONF': str(home / 'conf'),
                'PROLE_DATA': str(home / 'data'),
                'PROLE_LOGS': str(home / 'logs'),
                'PROLE_SERVICE': str(home / 'etc'),
            }
            self._save_env_to_file(vals)
        # Validate readability
        try:
            data = env_file.read_text()
            if not isinstance(data, str) or len(data) == 0:
                raise Exception("env.sh is empty")
        except Exception as e:
            raise Exception(f"env.sh not readable at {env_file}: {e}")
        return home

    def reload_env_from_shell(self) -> None:
        """Reload environment by sourcing $PROLE_HOME/env.sh in a login shell and merging into os.environ."""
        home = self.ensure_prole_env()
        env_file = home / 'env.sh'
        # Use bash to source and print env in null-delimited form
        cmd = (
            f'export PROLE_HOME={shlex.quote(str(home))}; '
            f'source {shlex.quote(str(env_file))}; '
            'env -0'
        )
        try:
            out = subprocess.check_output(['bash', '-lc', cmd])
        except subprocess.CalledProcessError as e:
            raise Exception(f"Failed to reload environment: {e}")
        except Exception as e:
            raise Exception(f"Failed to run bash to reload environment: {e}")
        # Merge variables
        try:
            items = out.split(b'\x00')
            for raw in items:
                if not raw:
                    continue
                try:
                    kv = raw.decode('utf-8', errors='ignore')
                except Exception:
                    continue
                if '=' not in kv:
                    continue
                k, v = kv.split('=', 1)
                # Avoid clobbering Python internals we rely on; safe list only
                if k in ('PYTHONPATH', 'PYTHONHOME'):
                    continue
                os.environ[k] = v
        except Exception:
            # Best-effort; ignore merge errors
            pass
    def _env_defaults(self) -> dict:
        home = Path.home() / '.prole'
        namespace = ""
        try:
            namespace = self.db_namespace.get()
        except Exception:
            namespace = os.environ.get('NAMESPACE', '')
        return {
            'PROLE_HOME': str(home),
            'PROLE_CONF': str(home / 'conf'),
            'PROLE_DATA': str(home / 'data'),
            'PROLE_LOGS': str(home / 'logs'),
            'PROLE_SERVICE': str(home / 'etc'),
            'NAMESPACE': namespace,
        }

    def _read_existing_env(self) -> dict:
        # Best effort: read $PROLE_HOME/env.sh if present
        env = {}
        # Try current env var first
        prole_home = os.environ.get('PROLE_HOME')
        candidates = []
        if prole_home:
            candidates.append(Path(prole_home).expanduser() / 'env.sh')
        # Also check default location
        candidates.append(Path.home() / '.prole' / 'env.sh')
        for p in candidates:
            try:
                if p.exists():
                    for line in p.read_text().splitlines():
                        line = line.strip()
                        if not line or line.startswith('#'):
                            continue
                        # expect lines like: export NAME="value"
                        if line.startswith('export '):
                            line = line[len('export '):]
                        if '=' in line:
                            k, v = line.split('=', 1)
                            env[k.strip()] = v.strip().strip('"')
                    break
            except Exception:
                pass
        return env

    def _resolve_env_value(self, key: str, fallback: str | None = None) -> str | None:
        val = os.environ.get(key)
        if val:
            return val
        try:
            env = self._read_existing_env()
            val = env.get(key)
            if val:
                return val
        except Exception:
            pass
        return fallback

    def _resolve_env_dir(self, key: str, default_suffix: str) -> Path:
        val = self._resolve_env_value(key)
        if val:
            try:
                return Path(val).expanduser()
            except Exception:
                pass
        return Path.home() / '.prole' / default_suffix

    def _resolve_prole_conf_dir(self) -> Path:
        return self._resolve_env_dir('PROLE_CONF', 'conf')

    def _resolve_prole_logs_dir(self) -> Path:
        return self._resolve_env_dir('PROLE_LOGS', 'logs')

    def _ensure_prole_directories(self) -> None:
        paths = {
            'PROLE_HOME': self._resolve_env_value('PROLE_HOME', str(Path.home() / '.prole')),
            'PROLE_CONF': str(self._resolve_prole_conf_dir()),
            'PROLE_DATA': str(self._resolve_env_dir('PROLE_DATA', 'data')),
            'PROLE_LOGS': str(self._resolve_prole_logs_dir()),
            'PROLE_SERVICE': str(self._resolve_env_dir('PROLE_SERVICE', 'etc')),
        }
        for key, raw in paths.items():
            try:
                Path(raw).expanduser().mkdir(parents=True, exist_ok=True)
            except Exception:
                pass
            if key not in os.environ and raw:
                os.environ[key] = raw

    def _record_install_log(self, path) -> None:
        if not path:
            return
        try:
            p = Path(path)
        except Exception:
            return
        if not hasattr(self, '_install_run_log_paths'):
            self._install_run_log_paths = []
        sp = str(p)
        if sp not in self._install_run_log_paths:
            self._install_run_log_paths.append(sp)

    def _get_local_owner(self) -> str:
        try:
            return getpass.getuser()
        except Exception:
            try:
                return os.getlogin()
            except Exception:
                return "prole"

    def _sanitize_namespace(self, name: str) -> str:
        cleaned = re.sub(r'[^a-z0-9-]+', '-', (name or '').lower())
        cleaned = re.sub(r'-{2,}', '-', cleaned).strip('-')
        if not cleaned:
            cleaned = 'prole'
        if len(cleaned) > 63:
            cleaned = cleaned[:63].rstrip('-')
        return cleaned

    def _generate_namespace_name(self) -> str:
        owner = self._sanitize_namespace(self._get_local_owner())
        suffix = uuid.uuid4().hex[:6]
        base = f"prole-{owner}-{suffix}"
        return self._sanitize_namespace(base)

    def _initial_namespace(self) -> str:
        try:
            existing = self._read_existing_env()
            ns = existing.get('NAMESPACE') or existing.get('PROLE_NAMESPACE')
            if ns:
                return self._ensure_namespace_prefix(ns)
        except Exception:
            pass
        ns = os.environ.get('NAMESPACE') or os.environ.get('PROLE_NAMESPACE')
        if ns:
            return self._ensure_namespace_prefix(ns)
        return self._ensure_namespace_prefix(self._generate_namespace_name())

    def _namespace_prefix(self) -> str:
        return NAMESPACE_PREFIX

    def _max_namespace_suffix_len(self) -> int:
        return max(0, POSTGRES_DB_NAME_MAX_LEN - len(self._namespace_prefix()))

    def _strip_namespace_prefix(self, name: str) -> str:
        prefix = self._namespace_prefix()
        if name.startswith(prefix):
            return name[len(prefix):]
        return name

    def _ensure_namespace_prefix(self, name: str) -> str:
        cleaned = (name or '').strip()
        prefix = self._namespace_prefix()
        if not cleaned:
            return prefix
        if cleaned.startswith(prefix):
            return cleaned
        return f"{prefix}{cleaned}"

    def _sync_namespace_suffix_from_full(self):
        if self._updating_namespace_fields:
            return
        self._updating_namespace_fields = True
        try:
            full = (self.db_namespace.get() or '').strip()
            full = self._ensure_namespace_prefix(full)
            if full != self.db_namespace.get():
                self.db_namespace.set(full)
            self.db_namespace_suffix.set(self._strip_namespace_prefix(full))
        finally:
            self._updating_namespace_fields = False

    def _sync_namespace_full_from_suffix(self):
        if self._updating_namespace_fields:
            return
        self._updating_namespace_fields = True
        try:
            suffix = (self.db_namespace_suffix.get() or '').strip()
            self.db_namespace.set(f"{self._namespace_prefix()}{suffix}")
        finally:
            self._updating_namespace_fields = False

    def _validate_namespace_suffix(self, proposed: str) -> bool:
        return len(proposed) <= self._max_namespace_suffix_len()

    def _is_valid_namespace(self, name: str) -> bool:
        if not name or len(name) > 63:
            return False
        return re.match(r'^[a-z0-9]([-a-z0-9]*[a-z0-9])?$', name) is not None

    def _parse_rfc3339(self, ts: str):
        if not ts:
            return None
        try:
            if ts.endswith('Z'):
                ts = ts[:-1] + '+00:00'
            return datetime.fromisoformat(ts)
        except Exception:
            return None

    def _format_pod_time(self, ts: str) -> str:
        dt = self._parse_rfc3339(ts)
        if not dt:
            return ts or '—'
        try:
            return dt.astimezone().strftime('%Y-%m-%d %H:%M:%S')
        except Exception:
            return dt.strftime('%Y-%m-%d %H:%M:%S')

    def _collect_namespace_rows(self):
        owner = self.namespace_owner or self._get_local_owner()
        ns_names = []
        notice = ""
        kubectl_ok = False

        try:
            result = subprocess.run(
                ['kubectl', 'get', 'ns', '-o', 'json'],
                capture_output=True,
                text=True,
                timeout=5
            )
            if result.returncode == 0:
                kubectl_ok = True
                data = json.loads(result.stdout or "{}")
                for item in data.get('items', []):
                    name = item.get('metadata', {}).get('name')
                    if name:
                        ns_names.append(name)
            else:
                notice = (result.stderr or '').strip() or "kubectl returned a non-zero status."
        except FileNotFoundError:
            notice = "kubectl not found; showing local defaults."
        except Exception as e:
            notice = f"Unable to query namespaces: {e}"

        current_ns = (self.db_namespace.get() or '').strip()
        prefix = self._namespace_prefix()
        ns_names = [name for name in ns_names if name.startswith(prefix) or name == 'supabase']
        if current_ns and (current_ns.startswith(prefix) or current_ns == 'supabase') and current_ns not in ns_names:
            ns_names.append(current_ns)
        if not ns_names:
            if current_ns and (current_ns.startswith(prefix) or current_ns == 'supabase'):
                ns_names = [current_ns]
            else:
                ns_names = []

        pods_by_ns = {}
        if kubectl_ok:
            try:
                pods_result = subprocess.run(
                    ['kubectl', 'get', 'pods', '--all-namespaces', '-o', 'json'],
                    capture_output=True,
                    text=True,
                    timeout=8
                )
                if pods_result.returncode == 0:
                    pods_data = json.loads(pods_result.stdout or "{}")
                    for pod in pods_data.get('items', []):
                        meta = pod.get('metadata', {})
                        status = pod.get('status', {})
                        ns = meta.get('namespace')
                        if not ns:
                            continue
                        entry = pods_by_ns.setdefault(ns, {'starts': [], 'running': False})
                        start_time = status.get('startTime')
                        if start_time:
                            entry['starts'].append(start_time)
                        if status.get('phase') == 'Running':
                            entry['running'] = True
                else:
                    notice = notice or (pods_result.stderr or '').strip() or notice
            except Exception:
                # Best effort only
                pass

        rows = []
        for ns in sorted(set(ns_names)):
            entry = pods_by_ns.get(ns, {'starts': [], 'running': False})
            oldest = None
            if entry['starts']:
                parsed = [self._parse_rfc3339(ts) for ts in entry['starts']]
                parsed = [p for p in parsed if p is not None]
                if parsed:
                    oldest_dt = min(parsed)
                    oldest = oldest_dt.isoformat()
                else:
                    oldest = min(entry['starts'])
            creation = self._format_pod_time(oldest) if oldest else '—'
            status = 'active' if entry['running'] else 'inactive'
            
            # Best effort to find port
            port = '—'
            if ns == 'supabase':
                port = '5432'
            else:
                # For prole-db namespaces
                if ns == (self.db_namespace.get() or '').strip():
                    if self.supabase_enabled.get():
                        port = '15432'
                    else:
                        port = self.db_host_port.get() or '5432'
                else:
                    # If it's another prole-db namespace, we might not know its port easily 
                    # but if Supabase is enabled globally, we assume standard alternate port
                    if self.supabase_enabled.get():
                        port = '15432'
                    else:
                        port = '5432'
                
            rows.append((ns, owner, port, creation, status))

        return rows, notice

    def _refresh_namespace_table(self):
        if getattr(self, '_refreshing_ns_table', False):
            return
        self._refreshing_ns_table = True

        def worker():
            try:
                rows, notice = self._collect_namespace_rows()
                current_ns = (self.db_namespace.get() or '').strip()

                def update_ui():
                    tree = getattr(self, '_db_namespace_tree', None)
                    if not tree:
                        return
                    for item in tree.get_children():
                        tree.delete(item)

                    for row in rows:
                        # Add checkbox-like symbol for selection
                        ns_name = row[0]
                        prefix = ' [✓] ' if ns_name == current_ns else ' [  ] '
                        display_row = (prefix,) + row
                        tree.insert('', 'end', values=display_row)

                    if current_ns:
                        for item in tree.get_children():
                            vals = tree.item(item, 'values')
                            if vals and vals[1] == current_ns:
                                tree.selection_set(item)
                                tree.see(item)
                                break

                    note_item = getattr(self, '_db_namespace_note', None)
                    if note_item and self.bg_canvas.winfo_exists():
                        msg = notice if notice else ""
                        self.bg_canvas.itemconfig(note_item, text=msg)

                self.safe_after(update_ui)
            finally:
                self._refreshing_ns_table = False

        threading.Thread(target=worker, daemon=True).start()

    def _db_set_status(self, message: str, color: str = '#6e6e73'):
        note_item = getattr(self, '_db_namespace_note', None)
        if note_item and self.bg_canvas.winfo_exists():
            self.bg_canvas.itemconfig(note_item, text=message or "", fill=color)

    def _db_set_buttons_state(self, state: str):
        buttons = getattr(self, '_db_action_buttons', None)
        if not buttons:
            return
        for btn in buttons:
            try:
                if btn.winfo_exists():
                    btn.configure(state=state)
            except Exception:
                pass

    def _db_selected_namespace(self) -> str:
        tree = getattr(self, '_db_namespace_tree', None)
        if not tree:
            return ""
        sel = tree.selection()
        if not sel:
            return ""
        vals = tree.item(sel[0], 'values')
        if not vals:
            return ""
        ns = vals[1]
        if ns == 'supabase':
            return ""
        return ns

    def _db_action_log_path(self) -> Path:
        logs_dir = PROJECT_ROOT / "logs"
        try:
            logs_dir.mkdir(parents=True, exist_ok=True)
        except Exception:
            pass
        return logs_dir / "db-actions.log"

    def _db_log(self, text: str):
        try:
            with self._db_action_log_path().open('a', encoding='utf-8') as fp:
                fp.write(text)
                if not text.endswith('\n'):
                    fp.write('\n')
        except Exception:
            pass

    def _run_cmd_capture(self, cmd, env=None, stdin_text=None, timeout=None):
        output_lines = []
        try:
            # Ensure PYTHONUNBUFFERED=1
            run_env = (env or os.environ).copy()
            run_env['PYTHONUNBUFFERED'] = '1'
            proc = subprocess.Popen(
                cmd,
                stdin=subprocess.PIPE if stdin_text is not None else None,
                stdout=subprocess.PIPE,
                stderr=subprocess.STDOUT,
                text=True,
                env=run_env
            )
        except Exception as e:
            return 1, f"Failed to start command: {e}"

        if stdin_text is not None and proc.stdin:
            try:
                proc.stdin.write(stdin_text)
                proc.stdin.close()
            except Exception:
                pass

        try:
            for line in proc.stdout:
                output_lines.append(line)
        except Exception:
            pass
        try:
            rc = proc.wait(timeout=timeout)
        except Exception:
            try:
                proc.kill()
            except Exception:
                pass
            rc = 1
        return rc, "".join(output_lines)

    def _script_env_for_namespace(self, namespace: str) -> dict:
        env = os.environ.copy()
        env["PROLE_HOME"] = str(PROJECT_ROOT)
        env["PROLE_SERVICE"] = str(PROJECT_ROOT)
        env["PROLE_DB_USER"] = self.db_username.get().strip()
        env["NAMESPACE"] = namespace
        if self.kerberos_realm.get().strip():
            env["KRB5_REALM"] = self.kerberos_realm.get().strip()
            env["REALM"] = self.kerberos_realm.get().strip()
            env["DOMAIN"] = self.kerberos_realm.get().strip().lower()
        if self.kerberos_kdc.get().strip():
            env["KRB5_KDC"] = self.kerberos_kdc.get().strip()
            env["KRB5_ADMIN"] = self.kerberos_kdc.get().strip()
        if self.kerberos_user.get().strip():
            env["KRB5_USER"] = self.kerberos_user.get().strip()
        if self.kerberos_password.get().strip():
            env["KRB5_PASSWORD"] = self.kerberos_password.get().strip()
        return env

    def _db_add_namespace(self):
        ns = (self.db_namespace.get() or '').strip()
        if not ns:
            messagebox.showerror('Database Name', 'Database namespace cannot be empty.')
            return
        if not self._is_valid_namespace(ns):
            messagebox.showerror('Database Name', 'Namespace must be lowercase alphanumeric or "-", start/end with a letter or number, and be 63 characters or less.')
            return
        self.db_namespace.set(ns)

        def worker():
            self.safe_after(lambda: self._db_set_buttons_state('disabled'))
            self.safe_after(lambda: self._db_set_status(f"Creating namespace {ns}...", '#1d1d1f'))
            rc, out = self._run_cmd_capture(['kubectl', 'create', 'namespace', ns])
            if rc != 0 and 'AlreadyExists' not in out:
                self._db_log(out)
                self.safe_after(self._refresh_namespace_table)
                self.safe_after(lambda: self._db_set_status(f"Failed to create namespace {ns}. See logs/db-actions.log.", '#ff3b30'))
            else:
                self._update_env_namespace(ns)
                self.safe_after(self._refresh_namespace_table)
                self.safe_after(lambda: self._db_set_status(f"Namespace {ns} is ready.", '#34c759'))
            self.safe_after(lambda: self._db_set_buttons_state('normal'))

        threading.Thread(target=worker, daemon=True).start()

    def _db_delete_namespace(self):
        ns = self._db_selected_namespace() or (self.db_namespace.get() or '').strip()
        if not ns:
            messagebox.showerror('Delete Database', 'Select a database namespace to delete.')
            return
        if not messagebox.askyesno('Delete Database', f'Delete namespace "{ns}"? This cannot be undone.'):
            return

        def worker():
            self.safe_after(lambda: self._db_set_buttons_state('disabled'))
            self.safe_after(lambda: self._db_set_status(f"Deleting namespace {ns}...", '#1d1d1f'))
            rc, out = self._run_cmd_capture(['kubectl', 'delete', 'namespace', ns])
            if rc != 0:
                self._db_log(out)
                self.safe_after(self._refresh_namespace_table)
                self.safe_after(lambda: self._db_set_status(f"Failed to delete namespace {ns}. See logs/db-actions.log.", '#ff3b30'))
            else:
                self.safe_after(self._refresh_namespace_table)
                self.safe_after(lambda: self._db_set_status(f"Namespace {ns} deleted.", '#34c759'))
            self.safe_after(lambda: self._db_set_buttons_state('normal'))

        threading.Thread(target=worker, daemon=True).start()

    def _db_edit_namespace(self):
        ns = self._db_selected_namespace() or (self.db_namespace.get() or '').strip()
        if not ns:
            messagebox.showerror('Edit Database', 'Select a database namespace to edit.')
            return
        self.db_namespace.set(ns)
        if not self._is_valid_namespace(ns):
            messagebox.showerror('Database Name', 'Namespace must be lowercase alphanumeric or "-", start/end with a letter or number, and be 63 characters or less.')
            return
        p1 = self.db_password.get()
        p2 = self.db_password_confirm.get()
        if not p1:
            messagebox.showerror('Password', 'Password cannot be empty.')
            return
        if p1 != p2:
            messagebox.showerror('Password', 'Passwords do not match.')
            return

        def worker():
            self.safe_after(lambda: self._db_set_buttons_state('disabled'))
            self.safe_after(lambda: self._db_set_status(f"Recreating SSH key for {ns}...", '#1d1d1f'))
            # We prefer ed25519, but fallback to rsa if not available
            key_path = Path.home() / ".ssh" / "id_prole_ed25519"
            pub_path = Path.home() / ".ssh" / "id_prole_ed25519.pub"
            try:
                if key_path.exists():
                    key_path.unlink()
                if pub_path.exists():
                    pub_path.unlink()
            except Exception:
                pass

            cmd = ["ssh-keygen", "-t", "ed25519", "-N", "", "-f", str(key_path), "-C", self.db_username.get().strip()]
            rc, out = self._run_cmd_capture(cmd)
            if rc != 0:
                self._db_log(f"ed25519 generation failed, falling back to rsa: {out}")
                cmd = ["ssh-keygen", "-t", "rsa", "-b", "4096", "-N", "", "-f", str(key_path), "-C", self.db_username.get().strip()]
                rc, out = self._run_cmd_capture(cmd)
            
            self._db_log(out)
            if rc != 0:
                self.safe_after(lambda: self._db_set_status("Failed to recreate SSH key. See logs/db-actions.log.", '#ff3b30'))
                self.safe_after(lambda: self._db_set_buttons_state('normal'))
                return

            self.safe_after(lambda: self._db_set_status("Updating OpenBao...", '#1d1d1f'))
            env = self._script_env_for_namespace(ns)
            env["AT_REST_ENCRYPTION_ENABLED"] = _bool_str(self.at_rest_encryption_enabled.get())
            script_path = str(PROJECT_ROOT / "etc" / "init_openbao.sh")
            rc2, out2 = self._run_cmd_capture(['bash', script_path, 'initialize'], env=env, stdin_text=f"{p1}\n")
            self._db_log(out2)
            if rc2 != 0:
                self.safe_after(self._refresh_namespace_table)
                self.safe_after(lambda: self._db_set_status("OpenBao update failed. See logs/db-actions.log.", '#ff3b30'))
            else:
                self._update_env_namespace(ns)
                self.safe_after(self._refresh_namespace_table)
                self.safe_after(lambda: self._db_set_status(f"Updated SSH key and OpenBao for {ns}.", '#34c759'))
            self.safe_after(lambda: self._db_set_buttons_state('normal'))

        threading.Thread(target=worker, daemon=True).start()

    def _update_env_namespace(self, namespace: str):
        try:
            existing = self._read_existing_env()
            defaults = self._env_defaults()
            values = {**defaults, **existing}
            values['NAMESPACE'] = namespace
            self._save_env_to_file(values)
            os.environ['NAMESPACE'] = namespace
        except Exception as e:
            print(f"[WARN] Failed to update env.sh namespace: {e}")

    def _save_env_to_file(self, values: dict):
        home = Path(values['PROLE_HOME']).expanduser()
        # ensure base dir exists
        home.mkdir(parents=True, exist_ok=True)
        # ensure subdirs exist
        for key in ('PROLE_CONF', 'PROLE_DATA', 'PROLE_LOGS', 'PROLE_SERVICE'):
            try:
                Path(values[key]).expanduser().mkdir(parents=True, exist_ok=True)
            except Exception:
                pass
        # write env.sh atomically
        content = []
        # Executable wrapper + sourceable config
        content.append('#!/usr/bin/env bash')
        content.append('# Prole environment configuration')
        content.append('# This file is generated by the installer. Source it in new shells, or execute as a wrapper:')
        content.append('#   "$PROLE_HOME/env.sh" <command> [args…]')
        content.append('# shellcheck shell=bash')
        # Core PROLE_* directories
        for k in ('PROLE_HOME','PROLE_CONF','PROLE_DATA','PROLE_LOGS','PROLE_SERVICE'):
            content.append(f'export {k}="{values[k]}"')
        if values.get('NAMESPACE'):
            content.append(f'export NAMESPACE="{values["NAMESPACE"]}"')
        content.append('')
        # Ensure PATH contains common locations and $PROLE_HOME/bin (POSIX sh compatible)
        content.append('# Ensure PATH works for GUI-launched shells (Docker, etc.)')
        content.append('_prole_add_path() { case ":${PATH}:" in *":$1:"*) ;; *) PATH="$1:${PATH:-}" ;; esac; }')
        content.append('_prole_add_path "$PROLE_HOME/bin"')
        content.append('_prole_add_path "/opt/homebrew/bin"')
        content.append('_prole_add_path "/usr/local/bin"')
        content.append('_prole_add_path "/usr/bin"')
        content.append('_prole_add_path "/bin"')
        content.append('_prole_add_path "/usr/sbin"')
        content.append('_prole_add_path "/sbin"')
        content.append('export PATH')
        content.append('')
        content.append('# Add custom paths below if needed (examples):')
        content.append('')
        content.append('# If executed with arguments (and not sourced), run them under this environment')
        content.append('if [[ "${BASH_SOURCE[0]}" == "${0}" ]] && [ "$#" -gt 0 ]; then')
        content.append('  exec "$@"')
        content.append('fi')
        tmp = home / 'env.sh.tmp'
        out = home / 'env.sh'
        tmp.write_text('\n'.join(content) + '\n')
        tmp.replace(out)
        try:
            os.chmod(out, 0o755)
        except Exception:
            pass

        # After creating env.sh, deploy additional resources as requested:
        # 1) Deploy init-port-forward.sh into $PROLE_HOME (and ensure it's executable)
        # 2) Copy contents of src/prole/etc (or fallback to top-level etc) into $PROLE_SERVICE
        try:
            prole_home = Path(values['PROLE_HOME']).expanduser()
            prole_service = Path(values['PROLE_SERVICE']).expanduser()

            # Determine source for init-port-forward.sh
            # Preferred location under repo: PROJECT_ROOT/src/prole/etc/init-port-forward.sh
            init_pf_src_candidates = [
                PROJECT_ROOT / 'src' / 'prole' / 'etc' / 'init-port-forward.sh',
                PROJECT_ROOT / 'etc' / 'init-port-forward.sh',
            ]
            init_pf_src = next((p for p in init_pf_src_candidates if p.exists()), None)
            if init_pf_src is not None:
                init_pf_dst = prole_home / 'init-port-forward.sh'
                try:
                    data = init_pf_src.read_bytes()
                    init_pf_dst.write_bytes(data)
                    os.chmod(init_pf_dst, 0o755)
                except Exception:
                    # best effort, ignore errors
                    pass

            # Determine etc directory source
            etc_src_candidates = [
                PROJECT_ROOT / 'src' / 'prole' / 'etc',
                PROJECT_ROOT / 'etc',
            ]
            etc_src = next((p for p in etc_src_candidates if p.exists() and p.is_dir()), None)
            if etc_src is not None:
                try:
                    prole_service.mkdir(parents=True, exist_ok=True)
                except Exception:
                    pass

                # Copy files (non-recursive: contents of etc root). If subdirectories exist, copy them recursively.
                import shutil

                def _copy_item(src_path: Path, dst_path: Path):
                    try:
                        if src_path.is_dir():
                            # copy directory tree
                            if dst_path.exists():
                                # remove then copy to keep in sync
                                shutil.rmtree(dst_path, ignore_errors=True)
                            shutil.copytree(src_path, dst_path)
                        else:
                            shutil.copy2(src_path, dst_path)
                    except Exception:
                        pass

                try:
                    for item in etc_src.iterdir():
                        _copy_item(item, prole_service / item.name)
                except Exception:
                    pass
        except Exception:
            # overall best-effort; do not fail env creation if copies fail
            pass

    def _render_env_setup_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        # Task heading for clarity
        self._render_title('Environment', y=150)
        self._render_paragraph('Configure your Prole environment. You can accept defaults or choose custom locations. Changing PROLE_HOME will update the defaults for other paths.', y=200)

        defaults = self._env_defaults()
        existing = self._read_existing_env()
        values = {**defaults, **existing}

        # Keep entry widgets to read values on Next
        self._env_entries = {}

        labels = [
            ('PROLE_HOME', 'Base directory for data, configs, logs, and scripts'),
            ('PROLE_CONF', 'Configuration directory'),
            ('PROLE_DATA', 'Data directory'),
            ('PROLE_LOGS', 'Logs directory'),
            ('PROLE_SERVICE', 'System scripts directory'),
        ]

        x_label = 48
        x_field = 300
        x_btn = 850
        y = 280
        row_h = 75

        def browse(var_name: str):
            from tkinter import filedialog
            initial = self._env_entries[var_name].get() or Path.home()
            path = filedialog.askdirectory(title=f"Select {var_name}", initialdir=str(Path(initial).expanduser()))
            if path:
                self._env_entries[var_name].delete(0, 'end')
                self._env_entries[var_name].insert(0, path)
                if var_name == 'PROLE_HOME':
                    # Update dependent defaults if they still match old pattern
                    self._update_dependent_env_paths()

        # Draw rows
        for key, help_text in labels:
            self._canvas_items.append(ui.canvas_text(self, x_label, y, key, fill='black', font=('SF Pro Text', 12, 'bold'), anchor='w'))
            # Use tk.Entry and place on canvas via create_window
            entry = tk.Entry(self.bg_canvas, bg='white', fg='black', insertbackground='black',
                            highlightbackground='#CCCCCC', highlightthickness=1, relief='flat', font=('SF Pro Text', 11))
            entry.insert(0, values[key])
            entry_window = self.bg_canvas.create_window(x_field, y, window=entry, anchor='w', width=500, height=32)
            self._canvas_items.append(entry_window)
            self._overlay_widgets.append(entry)
            self._env_entries[key] = entry

            # Use tk.Button and place on canvas via create_window
            btn = tk.Button(self.bg_canvas, text='Browse…', command=lambda k=key: browse(k),
                           bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                           highlightbackground='#F5F5DC', highlightthickness=0,
                           relief='flat', font=('SF Pro Text', 11), padx=10, pady=4)
            btn_window = self.bg_canvas.create_window(x_btn, y, window=btn, anchor='w', width=120)
            self._canvas_items.append(btn_window)
            self._overlay_widgets.append(btn)

            # hint text
            self._canvas_items.append(ui.canvas_text(self, x_field, y+24, help_text, fill='#6e6e73', font=('SF Pro Text', 10), anchor='nw'))
            y += row_h

        # When PROLE_HOME changes, update dependent paths that still follow default pattern
        def on_home_change(_evt=None):
            self._update_dependent_env_paths()
        try:
            self._env_entries['PROLE_HOME'].bind('<FocusOut>', on_home_change)
        except Exception:
            pass

    def _after_env_saved(self):
        """Reload the installer process environment after saving env.sh."""
        try:
            self.reload_env_from_shell()
            # Ensure we capture PROLE_HOME in Global section
            self.prole_cfg_data['Global']['PROLE_HOME'] = os.environ.get('PROLE_HOME', '')
            self._save_prole_cfg()
        except Exception as e:
            try:
                messagebox.showwarning('Environment', f'Environment saved, but reload failed: {e}')
            except Exception:
                pass

    def _collect_input_snapshot(self) -> dict:
        """Collect all possible user inputs for prole.cfg replay."""
        inputs: dict[str, str] = {}

        def _set(key: str, val):
            inputs[key] = '' if val is None else str(val)

        def _set_bool(key: str, val: bool):
            inputs[key] = _bool_str(bool(val))

        def _get_var(var, default=''):
            try:
                return var.get()
            except Exception:
                return default

        def _action(key: str, default: bool):
            return bool(self._action_flags.get(key, default))

        # Dependencies
        _set_bool('dependencies.verify_all', _get_var(self.verify_mode, False))
        _set_bool('dependencies.auto_install_missing', _action('dependencies.auto_install_missing', DEFAULT_ACTION_FLAGS.get('dependencies.auto_install_missing', True)))
        for dep in self.dependencies:
            dep_key = f"dependencies.{dep['id']}.install"
            _set_bool(dep_key, _action(dep_key, True))

        # Network scan
        _set_bool('network_scan.run', _action('network_scan.run', DEFAULT_ACTION_FLAGS.get('network_scan.run', True)))

        # Environment setup values
        env_vals = {}
        try:
            env_vals.update(self._env_defaults())
        except Exception:
            pass
        try:
            env_vals.update(self._read_existing_env())
        except Exception:
            pass
        for k in ('PROLE_HOME', 'PROLE_CONF', 'PROLE_DATA', 'PROLE_LOGS', 'PROLE_SERVICE'):
            if os.environ.get(k):
                env_vals[k] = os.environ.get(k)
        if hasattr(self, '_env_entries'):
            for k, ent in self._env_entries.items():
                try:
                    v = ent.get().strip()
                    if v:
                        env_vals[k] = v
                except Exception:
                    pass
        for k in ('PROLE_HOME', 'PROLE_CONF', 'PROLE_DATA', 'PROLE_LOGS', 'PROLE_SERVICE'):
            _set(f'env_setup.{k}', env_vals.get(k, ''))
        ns_val = (str(_get_var(self.db_namespace, '')).strip()) if hasattr(self, 'db_namespace') else ''
        if not ns_val:
            ns_val = env_vals.get('NAMESPACE', '')
        _set('env_setup.NAMESPACE', ns_val)

        # Database creation
        _set('init_password.db_namespace', ns_val)
        _set('init_password.db_username', _get_var(self.db_username, ''))
        _set('init_password.db_password', _get_var(self.db_password, ''))
        _set('init_password.db_password_confirm', _get_var(self.db_password_confirm, ''))
        _set('init_password.db_host_port', _get_var(self.db_host_port, '5432'))
        _set_bool('init_password.generate_ssh_key', _action('init_password.generate_ssh_key', DEFAULT_ACTION_FLAGS.get('init_password.generate_ssh_key', True)))

        # Build DB image
        _set_bool('init_db_build.run_build', _action('init_db_build.run_build', DEFAULT_ACTION_FLAGS.get('init_db_build.run_build', True)))

        # Cluster init + optional features
        _set('init_cluster.cluster_env', _get_var(self.cluster_env, 'dev'))
        _set_bool('init_cluster.supabase_enabled', _get_var(self.supabase_enabled, False))
        _set_bool('init_cluster.kerberos_enabled', _get_var(self.kerberos_enabled, False))
        _set_bool('init_cluster.at_rest_encryption_enabled', _get_var(self.at_rest_encryption_enabled, False))
        _set_bool('init_cluster.start_cluster', _action('init_cluster.start_cluster', DEFAULT_ACTION_FLAGS.get('init_cluster.start_cluster', True)))

        # Kerberos config
        _set_bool('kerberos_config.enabled', _get_var(self.kerberos_enabled, False))
        _set('kerberos_config.realm', _get_var(self.kerberos_realm, ''))
        _set('kerberos_config.kdc', _get_var(self.kerberos_kdc, ''))
        _set('kerberos_config.user', _get_var(self.kerberos_user, ''))
        _set('kerberos_config.password', _get_var(self.kerberos_password, ''))
        _set_bool('kerberos_config.test_connection', _action('kerberos_config.test_connection', DEFAULT_ACTION_FLAGS.get('kerberos_config.test_connection', False)))
        _set_bool('kerberos_config.init_authority', _action('kerberos_config.init_authority', DEFAULT_ACTION_FLAGS.get('kerberos_config.init_authority', False)))

        # Init scripts + deploy
        _set_bool('init_scripts.run_scripts', _action('init_scripts.run_scripts', DEFAULT_ACTION_FLAGS.get('init_scripts.run_scripts', True)))
        _set_bool('init_cnpg_deploy.run_deploy', _action('init_cnpg_deploy.run_deploy', DEFAULT_ACTION_FLAGS.get('init_cnpg_deploy.run_deploy', True)))
        _set_bool('init_cnpg_deploy.force_rollout', _action('init_cnpg_deploy.force_rollout', DEFAULT_ACTION_FLAGS.get('init_cnpg_deploy.force_rollout', False)))

        # Disk selection (installer packaging)
        _set('disk_selection.disk_type', _get_var(self.selected_disk_type, 'local'))
        _set('disk_selection.removable_mount', _get_var(self.selected_removable_disk, ''))
        _set('disk_selection.local_path', _get_var(self.selected_local_path, str(Path.home())))

        # Build tools app
        _set('build.deploy_env', getattr(self, 'deploy_env_value', 'Dev'))
        _set_bool('build.run_build', _action('build.run_build', DEFAULT_ACTION_FLAGS.get('build.run_build', False)))

        return inputs

    def _is_port_available(self, port: int) -> bool:
        """Check if a port is available on localhost."""
        import socket
        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
            try:
                s.bind(('127.0.0.1', port))
                return True
            except socket.error:
                return False

    def _show_port_error(self, port: int):
        """Show error message when port is in use, with option to see lsof output."""
        msg = f"Port {port} is already in use on the local host.\n\nPlease choose a different port or stop the service using it."
        
        dialog = tk.Toplevel(self.root)
        dialog.title("Port In Use")
        dialog.geometry("450x200")
        dialog.configure(bg='white')
        dialog.transient(self.root)
        dialog.grab_set()

        tk.Label(dialog, text="Port Conflict", font=('SF Pro Text', 14, 'bold'), bg='white', fg='#ff3b30').pack(pady=(20, 10))
        tk.Label(dialog, text=msg, font=('SF Pro Text', 11), bg='white', fg='black', wraplength=400).pack(pady=10)

        btn_frame = tk.Frame(dialog, bg='white')
        btn_frame.pack(pady=20)

        def show_lsof():
            log_file = PROJECT_ROOT / "logs" / f"port_{port}_lsof.log"
            log_file.parent.mkdir(parents=True, exist_ok=True)
            try:
                res = subprocess.run(['lsof', '-i', f':{port}'], capture_output=True, text=True)
                content = res.stdout if res.stdout else f"No lsof output for port {port}. (Maybe permission denied?)"
                if res.stderr:
                    content += "\n\nError:\n" + res.stderr
                log_file.write_text(content)
                # Open the log file
                if platform.system() == 'Darwin':
                    subprocess.run(['open', str(log_file)])
                elif platform.system() == 'Windows':
                    os.startfile(str(log_file))
                else:
                    subprocess.run(['xdg-open', str(log_file)])
            except Exception as e:
                messagebox.showerror("Error", f"Failed to run lsof: {e}")

        tk.Button(btn_frame, text="Show Logs (lsof)", command=show_lsof, bg='#F5F5DC', relief='flat', padx=10).pack(side='left', padx=10)
        tk.Button(btn_frame, text="OK", command=dialog.destroy, bg='#007aff', fg='white', relief='flat', padx=20).pack(side='left', padx=10)

    def _save_prole_cfg(self):
        """Generates prole.cfg; master configuration file containing all values used in install process."""
        try:
            # Check port availability before saving
            # try:
            #     port_val = int(self.db_host_port.get().strip())
            #     if not self._is_port_available(port_val):
            #         self._show_port_error(port_val)
            #         return
            # except ValueError:
            #     messagebox.showerror("Invalid Port", "Please enter a valid numeric port.")
            #     return

            # Determine path: prole/conf/prole.cfg
            # If PROLE_CONF is set, use it. Otherwise fallback to PROJECT_ROOT/prole/conf
            if self._cfg_path_override is not None:
                cfg_path = self._cfg_path_override
                if cfg_path.is_dir():
                    conf_dir = cfg_path
                    cfg_path = conf_dir / 'prole.cfg'
                else:
                    conf_dir = cfg_path.parent
            else:
                prole_conf = os.environ.get('PROLE_CONF')
                if prole_conf:
                    conf_dir = Path(prole_conf).expanduser()
                else:
                    conf_dir = PROJECT_ROOT / 'prole' / 'conf'
                cfg_path = conf_dir / 'prole.cfg'
            
            conf_dir.mkdir(parents=True, exist_ok=True)

            # Identify global candidates
            globals_to_save = {
                'PROLE_HOME': os.environ.get('PROLE_HOME', ''),
                'PROLE_DB_USER': self.db_username.get(),
                'DB_PASSWORD': self.db_password.get(),
                'CLUSTER_ENV': self.cluster_env.get(),
                'NAMESPACE': (self.db_namespace.get() or '').strip(),
                'DB_HOST_PORT': (self.db_host_port.get() or '5432').strip()
            }
            # Add any other values already in self.prole_cfg_data['Global']
            globals_to_save.update(self.prole_cfg_data.get('Global', {}))
            
            # Inputs section (replayable UI inputs)
            try:
                inputs = self._collect_input_snapshot()
            except Exception:
                inputs = {}

            sections = {k: self.prole_cfg_data.get(k, {}) for k in [
                'Welcome', 'Dependencies', 'Network', 'System Environment',
                'Kerberos Authentication', 'Optional Features', 'Database Creation',
                'Initialize Cluster', 'Docker Build', 'Initialization Scripts',
                'Prole DB Deploy', 'Install'
            ]}

            cfg_text = _render_prole_cfg(inputs, globals_to_save, sections)
            cfg_path.write_text(cfg_text)
            print(f"[DEBUG] prole.cfg saved to {cfg_path}")
            
        except Exception as e:
            print(f"[ERROR] Failed to save prole.cfg: {e}")

    def _update_dependent_env_paths(self):
        try:
            new_home = Path(self._env_entries['PROLE_HOME'].get()).expanduser()
        except Exception:
            return
        mapping = {
            'PROLE_CONF': new_home / 'conf',
            'PROLE_DATA': new_home / 'data',
            'PROLE_LOGS': new_home / 'logs',
            'PROLE_SERVICE': new_home / 'etc',
        }
        # Update entries if they are empty or previously matched the old base
        for key, new_path in mapping.items():
            ent = self._env_entries.get(key)
            if not ent:
                continue
            cur = ent.get().strip()
            if not cur:
                ent.delete(0, 'end')
                ent.insert(0, str(new_path))
                continue
            # If cur looked like old_home/<suffix>, update it
            try:
                # detect suffix
                suffix = new_path.name
                if cur.endswith('/' + suffix):
                    # replace base path
                    ent.delete(0, 'end')
                    ent.insert(0, str(new_path))
            except Exception:
                pass
        # done

    def _render_title(self, text, y=40):
        ui.render_title(self, text, y)

    def _render_paragraph(self, text, y, wrap=600):
        ui.render_paragraph(self, text, y, wrap)

    def _create_console_output(self, y=280, title="Scan Output", width=880, height=450):
        """Create a standardized console output area with a label and scrollable text."""
        # Section title/label for the console
        ui.canvas_text(self, 48, y, title, fill='#1d1d1f', font=('SF Pro Text', 12, 'bold'))
        
        y_console = y + 30
        # Use a background frame to ensure NO borders are visible around the console
        console_bg = tk.Frame(self.bg_canvas, bg='white', highlightthickness=0, bd=0)
        console = ui.TerminalConsole(console_bg, highlightthickness=0, bd=0)
        console.pack(fill='both', expand=True, padx=1, pady=1)
        
        console_window = self.bg_canvas.create_window(48, y_console, window=console_bg, 
                                                       anchor='nw', width=width, height=height)
        self._canvas_items.append(console_window)
        self._overlay_widgets.append(console_bg)
        self._overlay_widgets.append(console)
        return console

    def _render_welcome_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975 # 1300 * 0.75 approx
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        # Welcome title
        self._render_title('Welcome', y=150)
        
        welcome_text = (
            "This installer will guide you through the process of setting up the Prole Database and its supporting "
            "infrastructure. We have designed this process to be as automated as possible, ensuring that your "
            "deployment is secure, efficient, and tailored to your specific network environment.\n\n"
            "What to expect:\n"
            "• Network Environment Discovery: We'll scan for existing services like Active Directory and DNS.\n"
            "• System Configuration: Setting up local paths and environment variables.\n"
            "• Dependency Management: Ensuring all required tools (Docker, k3d, etc.) are ready.\n"
            "• Database Initialization: Configuring passwords, Kerberos authentication, and deploying the database cluster.\n\n"
            "We are excited to have you join our community and start building with us. "
            "Welcome to the neighborhood! Let's get started by preparing your system for the Prole experience."
        )
        
        ui.canvas_text(self, 48, 220, welcome_text, fill='black', font=('SF Pro Text', 13), width=750)
        
        # Ensure footer is updated (Next button visible)
        self.update_footer()

    def _render_network_scan_page(self):
        # Letterhead at top right (matching welcome screen theme)
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Network Configuration Scan', y=150)
        self._render_paragraph("The network prole-agent will detect Kerberos services, Active Directory controllers, and other configuration details required for deployment.", y=210)
        
        y = 280
        self.scan_status_var = tk.StringVar(value="Ready to prole-agent")
        # Ready to scan text (drawn on canvas)
        status_item = ui.canvas_text(self, 48, y, "Ready to prole-agent", fill='black', font=('SF Pro Text', 12))
        
        # Link variable to canvas text
        def update_status_text(*args):
            try:
                self.bg_canvas.itemconfig(status_item, text=self.scan_status_var.get())
            except Exception:
                pass
        self.scan_status_var.trace_add('write', update_status_text)

        # Standardized Console Output
        self.scan_results_console = self._create_console_output(y=320, title="Scan Output", width=880, height=380)
        self.scan_results_text = self.scan_results_console.text

        if getattr(self, 'ansible_topology_summary', ''):
            self.scan_results_console.write(self.ansible_topology_summary + "\n")
            self.scan_results_console.write("Ansible topology loaded; network scan can refine detection.\n")
        
        y = 740

        # Start Network Scan Button (placed on canvas)
        self.scan_btn = tk.Button(self.bg_canvas, text="Start Network Scan", command=self._run_network_scan,
                            bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                            highlightbackground='#F5F5DC', highlightthickness=0,
                            relief='flat', font=('SF Pro Text', 11), padx=20, pady=10)
        self.btn_window = self.bg_canvas.create_window(48, y, window=self.scan_btn, anchor='nw')
        self._overlay_widgets.append(self.scan_btn)
        self._canvas_items.append(self.btn_window)
        
        # Prepare animation frames
        if not GLOBAL_SCAN_FRAMES:
            try:
                from PIL import Image, ImageTk
                gif_path = get_resource_path('img/prole-type.gif')
                if gif_path.exists():
                    gif = Image.open(str(gif_path))
                    try:
                        while True:
                            # Create a copy and resize
                            frame = gif.copy().convert('RGBA')
                            frame.thumbnail((24, 24), Image.LANCZOS)
                            GLOBAL_SCAN_FRAMES.append(ImageTk.PhotoImage(frame))
                            gif.seek(len(GLOBAL_SCAN_FRAMES))
                    except EOFError:
                        pass
            except Exception as e:
                print(f"Error loading scan animation: {e}")
        self._scan_frames = GLOBAL_SCAN_FRAMES

        y += 60
        # Hint about auto-fill
        autofill_msg = "Scan results will auto-fill Kerberos and Environment settings."
        self._canvas_items.append(ui.canvas_text(self, 48, y, autofill_msg, fill='#6e6e73', font=('SF Pro Text', 10, 'italic')))

    def _animate_scan_button(self, frame_idx=0):
        if not getattr(self, '_scan_running', False) or not self._scan_frames:
            if hasattr(self, 'scan_btn'):
                self.scan_btn.config(image='', compound='none')
            return
        
        self.scan_btn.config(image=self._scan_frames[frame_idx], compound='left')
        next_idx = (frame_idx + 1) % len(self._scan_frames)
        self.root.after(100, lambda: self._animate_scan_button(next_idx))

    def _run_network_scan(self):
        if getattr(self, '_scan_running', False):
            return
        self._action_flags['network_scan.run'] = True
        self._scan_running = True
        self._scan_kdc_value = None
        ansible_kdc = ''
        try:
            ansible_kdc = (self.ansible_topology or {}).get('kdc_ip') or ''
            if not ansible_kdc:
                ansible_kdc = (self.prole_cfg_data.get('Network', {}) or {}).get('KDC_ANSIBLE_DETECTED', '')
        except Exception:
            ansible_kdc = ''
        
        self.scan_results_console.clear()
        self.scan_results_console.write("Initializing network scan using prole-net/prole-agent ...\n")
        self.scan_status_var.set("Scanning...")
        
        # Start animation
        if self._scan_frames:
            self._animate_scan_button()

        def worker():
            try:
                # Use the new scan binary
                scan_binary = get_resource_path("prole-net/prole-agent")
                if not scan_binary.exists():
                    self.safe_after(lambda: self.scan_results_console.write(f"Scan binary not found at {scan_binary}\n"))
                    self.safe_after(lambda: self.scan_status_var.set("Scan failed"))
                    self._scan_running = False
                    return

                # Create writable scan directory for output/cache
                # This avoids issues with PyInstaller's read-only _MEIPASS directory
                prole_home = Path.home() / ".prole"
                scan_dir = prole_home / "scan"
                scan_dir.mkdir(parents=True, exist_ok=True)

                # Run scan from writable directory with 10s timeout and summary analysis
                # Set bufsize=0 for truly unbuffered binary stream reading
                # Ensure PYTHONUNBUFFERED=1 is set in case prole-agent is/uses Python
                env = os.environ.copy()
                env['PYTHONUNBUFFERED'] = '1'
                process = subprocess.Popen([str(scan_binary), "-t", "10", "-s"],
                                         stdout=subprocess.PIPE,
                                         stderr=subprocess.STDOUT,
                                         bufsize=0,
                                         env=env,
                                         cwd=str(scan_dir))
                
                # Capture output in real-time using larger reads to avoid overhead
                fd = process.stdout.fileno()
                line_buffer = []
                last_ui_update = 0
                pending_output = []

                def maybe_set_kdc(ip: str):
                    if not ip:
                        return
                    if ansible_kdc:
                        return
                    if self._scan_kdc_value:
                        return
                    self._scan_kdc_value = ip
                    self.safe_after(lambda i=ip: self.kerberos_kdc.set(i))
                    self.safe_after(lambda: self.kerberos_enabled.set(True))
                
                while True:
                    try:
                        # Use a smaller chunk size to encourage more frequent reads
                        chunk_bytes = os.read(fd, 1024)
                    except (EOFError, OSError):
                        chunk_bytes = b''
                    
                    if not chunk_bytes:
                        if process.poll() is not None:
                            break
                        # If we have pending output, flush it before sleeping
                        if pending_output:
                            text_to_flush = "".join(pending_output)
                            pending_output = []
                            self.safe_after(lambda t=text_to_flush: self.scan_results_console.write(t))
                            last_ui_update = time.time()
                        time.sleep(0.01)
                        continue
                    
                    text = chunk_bytes.decode('utf-8', errors='replace')
                    pending_output.append(text)
                    
                    # Update more frequently if we have enough data or enough time has passed
                    now = time.time()
                    if now - last_ui_update > 0.05 or sum(len(x) for x in pending_output) > 2048:
                        text_to_flush = "".join(pending_output)
                        pending_output = []
                        self.safe_after(lambda t=text_to_flush: self.scan_results_console.write(t))
                        last_ui_update = now
                    
                    # Accumulate for line parsing (for AD/KDC detection)
                    for char in text:
                        line_buffer.append(char)
                        if char == '\n':
                            line = "".join(line_buffer)
                            line_buffer = []
                            
                            # Parse "KDC is: IP" from the new summary analysis format
                            if "KDC is:" in line:
                                try:
                                    ip_part = line.split("KDC is:")[1].strip()
                                    ip = ip_part.split()[0].strip('[]():,')
                                    if ip:
                                        maybe_set_kdc(ip)
                                except (IndexError, ValueError):
                                    pass

                            elif "Active Directory" in line or "88" in line:
                                parts = line.split()
                                for part in parts:
                                    try:
                                        socket.inet_aton(part.strip('[]():,'))
                                        ip = part.strip('[]():,')
                                        maybe_set_kdc(ip)
                                        break
                                    except socket.error:
                                        continue

                process.wait()
                
                # Final flush of any remaining output
                if pending_output:
                    text_to_flush = "".join(pending_output)
                    self.safe_after(lambda t=text_to_flush: self.scan_results_console.write(t))
                
                if process.returncode == 0:
                    self.safe_after(lambda: self.scan_status_var.set("Scan complete"))
                else:
                    self.safe_after(lambda: self.scan_status_var.set(f"Scan failed (code {process.returncode})"))
                
                self._scan_running = False

            except Exception as e:
                self.safe_after(lambda: self.scan_results_console.write(f"Scan error: {str(e)}\n"))
                self.safe_after(lambda: self.scan_status_var.set("Scan failed"))
                self._scan_running = False

        threading.Thread(target=worker, daemon=True).start()


    def _render_kerberos_config_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Kerberos Authentication', y=150)
        self._render_paragraph("Configure Kerberos authentication for Prole and the PostgreSQL database. Tests run inside the Kubernetes namespace to validate against your realm.", y=200)

        y = 280
        # Use tk.Checkbutton on canvas
        enable_cb = tk.Checkbutton(self.bg_canvas, text="Enable Kerberos Authentication", 
                                   variable=self.kerberos_enabled, bg='white', fg='black',
                                   activebackground='white', selectcolor='white', font=('SF Pro Text', 11))
        cb_window = self.bg_canvas.create_window(48, y, window=enable_cb, anchor='nw')
        self._canvas_items.append(cb_window)
        self._overlay_widgets.append(enable_cb)

        x_field = 200
        field_w = 400

        y += 60
        ui.canvas_text(self, 48, y, "Kerberos Realm:", fill='black', font=('SF Pro Text', 12))
        realm_entry = tk.Entry(self.bg_canvas, textvariable=self.kerberos_realm, bg='white', fg='black',
                               insertbackground='black', highlightbackground='#CCCCCC', highlightthickness=1, 
                               relief='flat', font=('SF Pro Text', 11))
        realm_window = self.bg_canvas.create_window(x_field, y-4, window=realm_entry, anchor='nw', width=field_w, height=32)
        self._canvas_items.append(realm_window)
        self._overlay_widgets.append(realm_entry)

        y += 48
        ui.canvas_text(self, 48, y, "KDC Host/IP:", fill='black', font=('SF Pro Text', 12))
        kdc_entry = tk.Entry(self.bg_canvas, textvariable=self.kerberos_kdc, bg='white', fg='black',
                             insertbackground='black', highlightbackground='#CCCCCC', highlightthickness=1, 
                             relief='flat', font=('SF Pro Text', 11))
        kdc_window = self.bg_canvas.create_window(x_field, y-4, window=kdc_entry, anchor='nw', width=field_w, height=32)
        self._canvas_items.append(kdc_window)
        self._overlay_widgets.append(kdc_entry)

        y += 48
        ui.canvas_text(self, 48, y, "Username:", fill='black', font=('SF Pro Text', 12))
        user_entry = tk.Entry(self.bg_canvas, textvariable=self.kerberos_user, bg='white', fg='black',
                              insertbackground='black', highlightbackground='#CCCCCC', highlightthickness=1, 
                              relief='flat', font=('SF Pro Text', 11))
        user_window = self.bg_canvas.create_window(x_field, y-4, window=user_entry, anchor='nw', width=field_w, height=32)
        self._canvas_items.append(user_window)
        self._overlay_widgets.append(user_entry)

        y += 48
        ui.canvas_text(self, 48, y, "Password:", fill='black', font=('SF Pro Text', 12))
        pass_entry = tk.Entry(self.bg_canvas, textvariable=self.kerberos_password, show="*", bg='white', fg='black',
                              insertbackground='black', highlightbackground='#CCCCCC', highlightthickness=1, 
                              relief='flat', font=('SF Pro Text', 11))
        pass_window = self.bg_canvas.create_window(x_field, y-4, window=pass_entry, anchor='nw', width=field_w, height=32)
        self._canvas_items.append(pass_window)
        self._overlay_widgets.append(pass_entry)

        y += 60
        # Use tk.Button on canvas
        test_btn = tk.Button(self.bg_canvas, text="Test Connection", command=self.test_kerberos_connection,
                            bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                            highlightbackground='#F5F5DC', highlightthickness=0,
                            relief='flat', font=('SF Pro Text', 11), padx=16, pady=8)
        btn_window = self.bg_canvas.create_window(48, y, window=test_btn, anchor='nw')
        self._canvas_items.append(btn_window)
        self._overlay_widgets.append(test_btn)

        authority_btn = tk.Button(self.bg_canvas, text="Initialize Authority", command=self.run_kerberos_authority,
                            bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                            highlightbackground='#F5F5DC', highlightthickness=0,
                            relief='flat', font=('SF Pro Text', 11), padx=16, pady=8)
        authority_window = self.bg_canvas.create_window(220, y, window=authority_btn, anchor='nw')
        self._canvas_items.append(authority_window)
        self._overlay_widgets.append(authority_btn)
        self._kerberos_authority_button = authority_btn

        y += 60
        # Use tk.Text
        self.kerberos_status_text = tk.Text(self.bg_canvas, width=100, height=12, font=('Menlo', 10),
                                            bg='white', fg='black', insertbackground='black',
                                            highlightbackground='#CCCCCC', highlightthickness=1, relief='flat')
        status_window = self.bg_canvas.create_window(48, y, window=self.kerberos_status_text, anchor='nw', width=800, height=200)
        self._canvas_items.append(status_window)
        self._overlay_widgets.append(self.kerberos_status_text)

    def _render_supabase_config_page(self):
        # Letterhead at top right (matching welcome screen theme)
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Prole::Supabase', y=150)
        
        description = (
            "Launches the full Supabase open-source stack locally, following the\n"
            "README/DEVELOPERS guidance (Docker Compose). This is a multi-service deployment\n"
            "(Postgres, Auth, Storage, Realtime, Kong, Studio, etc.)"
        )
        self._render_paragraph(description, y=210)

        y = 280
        self._supabase_status_var = tk.StringVar(value="Ready")
        status_item = ui.canvas_text(self, 48, y, "Status: Ready", fill='black', font=('SF Pro Text', 12))
        
        def update_status_text(*args):
            try:
                self.bg_canvas.itemconfig(status_item, text=f"Status: {self._supabase_status_var.get()}")
            except Exception:
                pass
        self._supabase_status_var.trace_add('write', update_status_text)

        # Standardized Console Output
        self._supabase_console = self._create_console_output(y=320, title="Deployment Output", width=880, height=380)
        
        y = 740

        # Deploy Supabase Button
        self._supabase_deploy_button = tk.Button(self.bg_canvas, text="Deploy Supabase", command=self.run_supabase_deploy,
                            bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                            highlightbackground='#F5F5DC', highlightthickness=0,
                            relief='flat', font=('SF Pro Text', 11), padx=20, pady=10)
        btn_window = self.bg_canvas.create_window(48, y, window=self._supabase_deploy_button, anchor='nw')
        self._overlay_widgets.append(self._supabase_deploy_button)
        self._canvas_items.append(btn_window)

    def run_supabase_deploy(self):
        if getattr(self, '_supabase_deploying', False):
            return
        
        self._supabase_deploying = True
        self._supabase_deploy_button.configure(state='disabled')
        self._supabase_status_var.set("Deploying...")
        self._supabase_console.clear()
        
        def worker():
            env = os.environ.copy()
            env["PROLE_HOME"] = str(PROJECT_ROOT)
            
            self._supabase_console.write("Starting Supabase deployment...\n")
            
            # Use supabase.sh as requested in the issue
            # Mapping ~/dev/prole/supabase.sh to PROJECT_ROOT / "supabase.sh"
            script_path = PROJECT_ROOT / "supabase.sh"
            
            # If supabase.sh doesn't exist, we fallback to supabase/deploy.sh
            # following the same pattern as controller.run_script fallback logic
            if not script_path.exists():
                deploy_fallback = PROJECT_ROOT / "supabase" / "deploy.sh"
                if deploy_fallback.exists():
                    self._supabase_console.write(f"Warning: {script_path} not found. Falling back to {deploy_fallback}.\n")
                    script_to_run = "supabase/deploy.sh"
                else:
                    self._supabase_console.write(f"Error: {script_path} not found.\n")
                    self.safe_after(lambda: self._supabase_status_var.set("Failed (Script not found)"))
                    self._supabase_deploying = False
                    self._supabase_deploy_button.configure(state='normal')
                    return
            else:
                script_to_run = "supabase.sh"

            proc = self.controller.run_script(script_to_run, 
                                              on_line=lambda l: self._supabase_console.write(l + "\n"),
                                              env=env)
            
            if proc.returncode == 0:
                self._supabase_success = True
                self.safe_after(lambda: self._supabase_status_var.set("Deployed Successfully"))
                self._supabase_console.write("\nSupabase deployment completed successfully.\n")
            else:
                self._supabase_success = False
                self.safe_after(lambda: self._supabase_status_var.set(f"Failed (Code {proc.returncode})"))
                self._supabase_console.write(f"\nSupabase deployment failed with exit code {proc.returncode}.\n")
                
            self._supabase_deploying = False
            self._supabase_deploy_button.configure(state='normal')
            self.update_footer()

        threading.Thread(target=worker, daemon=True).start()

    def test_kerberos_connection(self):
        self._action_flags['kerberos_config.test_connection'] = True
        realm = self.kerberos_realm.get().strip()
        user = self.kerberos_user.get().strip()
        password = self.kerberos_password.get().strip()
        kdc = self.kerberos_kdc.get().strip()
        
        if not realm or not user or not password or not kdc:
            messagebox.showerror("Error", "Please fill in realm, KDC host, username, and password.")
            return

        try:
            self.prole_cfg_data['Kerberos Authentication']['ENABLED'] = str(self.kerberos_enabled.get())
            self.prole_cfg_data['Kerberos Authentication']['REALM'] = realm
            self.prole_cfg_data['Kerberos Authentication']['KDC'] = kdc
            self.prole_cfg_data['Kerberos Authentication']['SERVER'] = kdc
            self.prole_cfg_data['Kerberos Authentication']['USER'] = user
            self.prole_cfg_data['Kerberos Authentication']['PASSWORD'] = password
            self.prole_cfg_data['Kerberos Authentication']['AD_PORT_FORWARD'] = os.environ.get('KRB5_AD_PORT_FORWARD', '1')
            self.prole_cfg_data['Kerberos Authentication']['AD_TCP_PORTS'] = os.environ.get('KRB5_AD_TCP_PORTS', '88 389 445 464 636')
            self.prole_cfg_data['Kerberos Authentication']['AD_UDP_PORTS'] = os.environ.get('KRB5_AD_UDP_PORTS', '88 464')
            self.prole_cfg_data['Kerberos Authentication']['AD_PROXY_HOST_NETWORK'] = os.environ.get('KRB5_AD_PROXY_HOST_NETWORK', '1')
            self.prole_cfg_data['Kerberos Authentication']['AD_PROXY_IMAGE'] = os.environ.get('KRB5_AD_PROXY_IMAGE', 'alpine/socat')
            self.prole_cfg_data['Kerberos Authentication']['AD_PROXY_SERVICE'] = os.environ.get('KRB5_AD_SERVICE_NAME', 'prole-kerberos-ad-dc')
            self._save_prole_cfg()
        except Exception:
            pass

        self.kerberos_status_text.delete('1.0', tk.END)
        self.kerberos_status_text.insert(tk.END, f"Testing {user}@{realm} inside the cluster...\n")

        def worker():
            try:
                env = os.environ.copy()
                env["PROLE_HOME"] = str(PROJECT_ROOT)
                env["PROLE_SERVICE"] = str(PROJECT_ROOT)
                env["NAMESPACE"] = (self.db_namespace.get() or '').strip()
                env["KRB5_REALM"] = realm
                env["REALM"] = realm
                env["DOMAIN"] = realm.lower()
                env["KRB5_KDC"] = kdc
                env["KRB5_ADMIN"] = kdc
                env["KRB5_USER"] = user
                env["KRB5_PASSWORD"] = password
                env.setdefault("KRB5_AD_PORT_FORWARD", "1")

                def write_line(line):
                    def _do_write(l=line):
                        try:
                            if self.kerberos_status_text.winfo_exists():
                                self.kerberos_status_text.insert(tk.END, l)
                                self.kerberos_status_text.see(tk.END)
                        except (tk.TclError, RuntimeError):
                            pass
                    self.safe_after(_do_write)

                write_line("\n==> init_kerberos.sh test\n")
                rc2 = self.controller.run_script(
                    "init_kerberos.sh",
                    args=["test"],
                    env=env,
                    on_line=write_line
                )
                if rc2 == 0:
                    write_line("\nKerberos test completed successfully.\n")
                else:
                    write_line(f"\nKerberos test failed with code {rc2}\n")

            except Exception as e:
                def _do_error(msg=str(e)):
                    try:
                        if self.kerberos_status_text.winfo_exists():
                            self.kerberos_status_text.insert(tk.END, f"Error: {msg}\n")
                    except (tk.TclError, RuntimeError):
                        pass
                self.safe_after(_do_error)

        threading.Thread(target=worker, daemon=True).start()

    def run_kerberos_authority(self):
        self._action_flags['kerberos_config.init_authority'] = True
        if not self.kerberos_enabled.get():
            try:
                messagebox.showerror("Kerberos", "Enable Kerberos authentication before initializing authority.")
            except Exception:
                pass
            return

        try:
            self.prole_cfg_data['Kerberos Authentication']['ENABLED'] = str(self.kerberos_enabled.get())
            self.prole_cfg_data['Kerberos Authentication']['REALM'] = self.kerberos_realm.get().strip()
            self.prole_cfg_data['Kerberos Authentication']['KDC'] = self.kerberos_kdc.get().strip()
            self.prole_cfg_data['Kerberos Authentication']['SERVER'] = self.kerberos_kdc.get().strip()
            self.prole_cfg_data['Kerberos Authentication']['USER'] = self.kerberos_user.get().strip()
            self.prole_cfg_data['Kerberos Authentication']['PASSWORD'] = self.kerberos_password.get().strip()
            self._save_prole_cfg()
        except Exception:
            pass

        # Guard: only run if saved config indicates Kerberos enabled
        if not self.kerberos_enabled.get():
            try:
                messagebox.showerror("Kerberos", "Kerberos authentication must be enabled and saved in prole.cfg.")
            except Exception:
                pass
            return

        self.kerberos_status_text.delete('1.0', tk.END)
        self.kerberos_status_text.insert(tk.END, "Initializing Kerberos authority...\n")

        def worker():
            env = os.environ.copy()
            env["PROLE_HOME"] = str(PROJECT_ROOT)
            env["PROLE_SERVICE"] = str(PROJECT_ROOT)
            env["NAMESPACE"] = (self.db_namespace.get() or '').strip()
            if self.kerberos_realm.get().strip():
                env["KRB5_REALM"] = self.kerberos_realm.get().strip()
                env["REALM"] = self.kerberos_realm.get().strip()
                env["DOMAIN"] = self.kerberos_realm.get().strip().lower()
            if self.kerberos_kdc.get().strip():
                env["KRB5_KDC"] = self.kerberos_kdc.get().strip()
                env["KRB5_ADMIN"] = self.kerberos_kdc.get().strip()
            if self.kerberos_user.get().strip():
                env["KRB5_USER"] = self.kerberos_user.get().strip()
            if self.kerberos_password.get().strip():
                env["KRB5_PASSWORD"] = self.kerberos_password.get().strip()

            def write_line(line):
                def _do_write(l=line):
                    try:
                        if self.kerberos_status_text.winfo_exists():
                            self.kerberos_status_text.insert(tk.END, l)
                            self.kerberos_status_text.see(tk.END)
                    except (tk.TclError, RuntimeError):
                        pass
                self.safe_after(_do_write)

            rc_bao = self.controller.run_script(
                "init_openbao.sh",
                args=["start"],
                env=env,
                on_line=write_line
            )
            if rc_bao != 0:
                write_line(f"\nOpenBao start failed with code {rc_bao}\n")
                return

            write_line("\n==> init_authority.sh start\n")
            rc = self.controller.run_script(
                "init_authority.sh",
                args=["start"],
                env=env,
                on_line=write_line
            )
            if rc == 0:
                write_line("\nAuthority initialization completed successfully.\n")
            else:
                write_line(f"\nAuthority initialization failed with code {rc}\n")

        threading.Thread(target=worker, daemon=True).start()

    def _start_welcome_dependency_scan(self):
        self.splash_scan_running = True
        self.splash_scan_done_at = None
        self.splash_scan_started_at = time.time()

        deps = list(self.dependencies)
        total = len(deps)
        results = {}

        def set_status(text: str):
            try:
                if self._splash_status_item is not None:
                    # Replace existing text to avoid creating many items
                    self.bg_canvas.itemconfig(self._splash_status_item, text=text)
            except Exception:
                pass

        def worker():
            missing_names = []
            for idx, dep in enumerate(deps, start=1):
                try:
                    ok, location, version = self.get_dep_info(dep)
                except Exception:
                    ok, location, version = False, None, None
                results[dep['id']] = (ok, location, version)
                # Update status text progressively
                if ok:
                    txt = f"[{idx}/{total}] {dep['name']}: Installed"
                else:
                    txt = f"[{idx}/{total}] {dep['name']}: Not installed"
                    missing_names.append(dep['name'])
                self.safe_after(lambda s=txt: set_status(s))
                # tiny sleep to keep UI responsive without being too fast
                try:
                    time.sleep(0.02)
                except Exception:
                    pass

            # Final message
            final_msg = 'All dependencies installed.' if not missing_names else (
                'Preparing to install ... ' + ', '.join(missing_names)
            )
            def on_done():
                set_status(final_msg)
                self.splash_scan_running = False
                self.splash_scan_done_at = time.time()
                # Re-evaluate footer to potentially show Next
                self.update_footer()
                # Important: schedule a follow-up refresh slightly after the debounce window
                # so the Next button becomes visible without requiring further UI events.
                self.safe_after(self.update_footer, delay=600)
            self.safe_after(on_done)

        t = threading.Thread(target=worker, daemon=True)
        t.start()
        # Failsafe refresh slightly after the 8s gating window in case no UI events fire.
        self.safe_after(self.update_footer, delay=9000)

    def _render_deps_summary_page(self):
        self._render_title('Dependencies', y=40)
        y = 100
        # Draw each dependency row: status dot (blank initially), name, info
        row_gap = 36
        left = 56
        text_x = left + 28
        
        self.dep_status_items = {} # Store canvas IDs to update later
        self.dep_install_buttons = {} # Store button window items
        
        for dep in self.dependencies:
            # blank box (outline only initially)
            dot = ui.canvas_rectangle(self, left, y, left+18, y+18, outline='#6e6e73', width=2)
            self._canvas_items.append(dot)
            # name
            self._canvas_items.append(ui.canvas_text(self, text_x, y-2, dep['name'], fill='black', font=('SF Pro Text', 12, 'bold')))
            # info placeholder
            info = ui.canvas_text(self, text_x + 180, y, 'Checking...', fill='#6e6e73', font=('SF Pro Text', 11))
            self._canvas_items.append(info)
            
            self.dep_status_items[dep['id']] = {'dot': dot, 'info': info, 'y': y}
            y += row_gap

        # Message line
        msg_y = y + 30
        self.deps_msg_item = ui.canvas_text(self, 48, msg_y, 'Scanning system...', fill='#6e6e73', font=('SF Pro Text', 11))
        self._canvas_items.append(self.deps_msg_item)

        # Start async check
        threading.Thread(target=self._run_delayed_deps_check, daemon=True).start()

    def _run_delayed_deps_check(self):
        results = {}
        any_missing = False
        for dep in self.dependencies:
            ok, location, version = self.get_dep_info(dep)
            results[dep['id']] = (ok, location, version)
            
            # Update UI for this item
            def update_item(did=dep['id'], ok=ok, version=version):
                items = self.dep_status_items.get(did)
                if not items: return
                
                # Replace box with colored dot/check
                self.bg_canvas.delete(items['dot'])
                left = 56
                y = items['y']
                if ok:
                    items['dot'] = ui.canvas_oval(self, left, y, left+18, y+18, fill='#34c759', outline='')
                    # Add a small white checkmark inside the green dot
                    self.bg_canvas.create_line(left+5, y+9, left+8, y+12, fill='white', width=2, tags=f"page_item_{self.pages[self.page_index][0]}")
                    self.bg_canvas.create_line(left+8, y+12, left+13, y+6, fill='white', width=2, tags=f"page_item_{self.pages[self.page_index][0]}")
                else:
                    items['dot'] = ui.canvas_oval(self, left, y, left+18, y+18, fill='#ff3b30', outline='')
                    # Add "Click to install" button
                    btn = tk.Button(self.bg_canvas, text='Install', command=lambda d=did: self.show_page(f"dep_{d}"),
                                   bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                                   highlightbackground='#F5F5DC', highlightthickness=0,
                                   relief='flat', font=('SF Pro Text', 10), padx=8, pady=2)
                    btn_window = self.bg_canvas.create_window(left + 350, y, window=btn, anchor='nw')
                    self._overlay_widgets.append(btn)
                    self._canvas_items.append(btn_window)
                    self.dep_install_buttons[did] = btn_window
                
                info_text = self.normalize_version(version) if ok and version else ('Not installed' if not ok else '')
                self.bg_canvas.itemconfig(items['info'], text=info_text)
                
            self.safe_after(update_item)
            time.sleep(0.1) # small delay to show it checking one by one

        def final_update():
            missing = [d['name'] for d in self.dependencies if not results.get(d['id'], (False, None, None))[0]]
            if missing:
                msg = f"Preparing to install ... {', '.join(missing)}"
            else:
                msg = 'All dependencies installed.'
            try:
                if self.bg_canvas.winfo_exists() and self.deps_msg_item in self.bg_canvas.find_all():
                    self.bg_canvas.itemconfig(self.deps_msg_item, text=msg)
            except (tk.TclError, RuntimeError):
                pass
            self.update_footer()
            
        self.safe_after(final_update)

    def _render_dependency_page(self, dep):
        self._render_title(dep['name'], y=40)
        self._render_paragraph(dep['description'], y=88)
        # Status
        ok, location, version = self.get_dep_info(dep)
        y = 180
        left = 56
        if ok:
            self._canvas_items.append(ui.canvas_oval(self, left, y, left+18, y+18, fill='#34c759', outline=''))
            self._canvas_items.append(ui.canvas_text(self, left+32, y-2, 'Installed', fill='black', font=('SF Pro Text', 12, 'bold')))
            if location:
                self._canvas_items.append(ui.canvas_text(self, left+32, y+32, f'Location: {location}', fill='#6e6e73', font=('SF Pro Text', 11)))
            if version:
                ver = self.normalize_version(version)
                self._canvas_items.append(ui.canvas_text(self, left+32, y+56, f'Version: {ver}', fill='#6e6e73', font=('SF Pro Text', 11)))
        else:
            # Check if we should auto-install
            install_cmd = dep.get('install_cmd')
            if install_cmd and self._installing_dep_id != dep['id']:
                # Launch directly into installation
                self._canvas_items.append(ui.canvas_oval(self, left, y, left+18, y+18, fill='#ffd60a', outline=''))
                self._canvas_items.append(ui.canvas_text(self, left+32, y-2, 'Installing...', fill='black', font=('SF Pro Text', 12, 'bold')))
                # Trigger console-based install for brew/pip
                if 'brew install' in install_cmd or 'pip install' in install_cmd:
                    self.root.after(500, lambda: self._install_dep_in_console(dep))
                else:
                    self.root.after(500, lambda: self.open_terminal_with_command(install_cmd))
            elif self._installing_dep_id == dep['id']:
                self._canvas_items.append(ui.canvas_oval(self, left, y, left+18, y+18, fill='#ffd60a', outline=''))
                self._canvas_items.append(ui.canvas_text(self, left+32, y-2, 'Installing...', fill='black', font=('SF Pro Text', 12, 'bold')))
            else:
                self._canvas_items.append(ui.canvas_oval(self, left, y, left+18, y+18, fill='#ff9f0a', outline=''))
                self._canvas_items.append(ui.canvas_text(self, left+32, y-2, 'Not installed', fill='black', font=('SF Pro Text', 12, 'bold')))
                # Click to install link (if available)
                if install_cmd:
                    link_y = y + 40
                    link_text = ui.render_link(self, left+32, link_y, 'Click to install')
                    self._canvas_items.append(link_text)
                    self.bg_canvas.config(cursor='hand2')

                    def _on_click(event):
                        ex, ey = event.x, event.y
                        bbox = self.bg_canvas.bbox(link_text)
                        if bbox and bbox[0] <= ex <= bbox[2] and bbox[1] <= ey <= bbox[3]:
                            self.open_terminal_with_command(install_cmd)
                    self.bg_canvas.bind('<Button-1>', _on_click)

    def _install_dep_in_console(self, dep):
        """Run dependency installation in the embedded console."""
        if self._installing_dep_id == dep['id']:
            return
        try:
            self._action_flags[f"dependencies.{dep['id']}.install"] = True
        except Exception:
            pass
        
        install_cmd = dep.get('install_cmd')
        if not install_cmd:
            return

        self._installing_dep_id = dep['id']
        # Prepare log file
        logs_dir = PROJECT_ROOT / 'logs'
        try:
            logs_dir.mkdir(parents=True, exist_ok=True)
        except Exception:
            pass
        ts = time.strftime('%Y%m%d-%H%M%S')
        log_path = logs_dir / f"install-{dep['id']}-{ts}.log"
        
        # Show console
        self._ensure_console_overlay(radio_bottom_y=160)
        self._console_text.configure(state='normal')
        self._console_text.delete('1.0', tk.END)
        self._console_text.insert('end', f"Starting installation of {dep['name']}...\n")
        self._console_text.insert('end', f"Command: {install_cmd}\n\n")
        self._console_text.configure(state='disabled')
        
        def on_done(rc):
            self._installing_dep_id = None
            if rc == 0:
                self._append_console(f"\nSuccessfully installed {dep['name']}.\n")
                # Refresh status and re-render page
                self.root.after(1500, lambda: self.show_page(f"dep_{dep['id']}"))
            else:
                self._append_console(f"\nInstallation failed with exit code {rc}.\n")
                # Enable next button so user can retry or proceed if they fixed it manually
                try:
                    self.next_button.configure(state='normal', text='Next')
                except Exception:
                    pass

        self._run_in_console(install_cmd, str(log_path), on_complete=on_done)

    # ---------------- Initialize Screen Handlers ----------------

    def _run_preparation_overlay(self):
        """Prepare environment for database creation."""
        self._action_flags['init_password.generate_ssh_key'] = True
        self._clear_canvas_page()
        
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Preparing', y=150)
        self._render_paragraph('Preparing your environment for database creation.', y=200)
        
        # Output Console - standardized to match Docker Build screen
        console = self._create_console_output(y=260, title="", width=900, height=520)
        
        # Status Label
        status_label = ui.canvas_text(self, 48, 812, "Initializing...", fill='black', font=('SF Pro Text', 12))
        self._canvas_items.append(status_label)

        def worker():
            key_path = Path.home() / ".ssh" / "id_prole_ed25519"
            key_path.parent.mkdir(parents=True, exist_ok=True)
            password = self.db_password.get()
            namespace = (self.db_namespace.get() or '').strip()

            # Pre-pull dependent images into local registry before initialization
            try:
                self.safe_after(lambda: self.bg_canvas.itemconfig(status_label, text="Pre-pulling images...", fill='blue') if self.bg_canvas.winfo_exists() else None)
                pull_ok = self._prepull_images_to_registry(
                    include_supabase=self.supabase_enabled.get(),
                    include_kerberos_proxy=self.kerberos_enabled.get(),
                    log=console.write
                )
                if not pull_ok:
                    console.write("\n[WARN] Image pre-pull failed or incomplete. Continuing...\n")
            except Exception as e:
                console.write(f"\n[WARN] Image pre-pull error: {e}\n")

            if key_path.exists():
                console.write(f"Key already exists at {key_path}. Proceeding...\n")
                self.safe_after(lambda: self.bg_canvas.itemconfig(status_label, text="Keys present. Proceeding...", fill='#34c759') if self.bg_canvas.winfo_exists() else None)
                time.sleep(0.5)
            else:
                self.safe_after(lambda: self.bg_canvas.itemconfig(status_label, text="Preparing keys...", fill='blue') if self.bg_canvas.winfo_exists() else None)
                cmd = ["ssh-keygen", "-t", "ed25519", "-N", "", "-f", str(key_path), "-C", self.db_username.get()]
                console.write(f"Initializing secure access: {' '.join(cmd)}\n\n")
                
                proc = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True)
                while True:
                    line = proc.stdout.readline()
                    if not line and proc.poll() is not None:
                        break
                    if line:
                        console.write(line)
                
                if proc.returncode != 0:
                    console.write(f"\nPreparation failed, trying alternative (code {proc.returncode})\n")
                    cmd = ["ssh-keygen", "-t", "rsa", "-b", "4096", "-N", "", "-f", str(key_path), "-C", self.db_username.get()]
                    console.write(f"Initializing secure access: {' '.join(cmd)}\n\n")
                    proc = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True)
                    while True:
                        line = proc.stdout.readline()
                        if not line and proc.poll() is not None:
                            break
                        if line:
                            console.write(line)

                if proc.returncode == 0:
                    console.write("\nPreparation completed successfully.\n")
                    self.safe_after(lambda: self.bg_canvas.itemconfig(status_label, text="Preparation completed successfully.", fill='#34c759') if self.bg_canvas.winfo_exists() else None)
                else:
                    console.write(f"\nError during preparation (code {proc.returncode})\n")
                    self.safe_after(lambda: self.bg_canvas.itemconfig(status_label, text=f"Error during preparation (code {proc.returncode})", fill='#ff3b30') if self.bg_canvas.winfo_exists() else None)
                    # In case of error, we might want to let the user see it before continuing or stopping
                    time.sleep(2)
                    self.root.after(500, lambda: self.show_page('init_password'))
                    return

            # Initialize OpenBao and store keys/passwords
            self.safe_after(lambda: self.bg_canvas.itemconfig(status_label, text="Initializing OpenBao...", fill='blue') if self.bg_canvas.winfo_exists() else None)
            env = self._script_env_for_namespace(namespace)
            env["PROLE_DB_USER"] = self.db_username.get().strip()
            env["DB_PASSWORD"] = password
            env["AT_REST_ENCRYPTION_ENABLED"] = _bool_str(self.at_rest_encryption_enabled.get())
            if self.at_rest_encryption_enabled.get():
                console.write("At-rest encryption enabled: generating/storing TDE keys in OpenBao...\n")
            rc = self.controller.run_script(
                "init_openbao.sh",
                args=["initialize"],
                env=env,
                stdin_text=f"{password}\n",
                on_line=lambda l: console.write(l)
            )
            if rc != 0:
                console.write(f"\nOpenBao initialization failed (code {rc}).\n")
                self.safe_after(lambda: self.bg_canvas.itemconfig(status_label, text=f"OpenBao init failed (code {rc})", fill='#ff3b30') if self.bg_canvas.winfo_exists() else None)
                self.root.after(500, lambda: self.show_page('init_password'))
                return

            # Move to next page
            self.safe_after(lambda: self.bg_canvas.itemconfig(status_label, text="OpenBao ready. Proceeding...", fill='#34c759') if self.bg_canvas.winfo_exists() else None)
            self.root.after(1000, lambda: self.show_page('init_cluster'))

        threading.Thread(target=worker, daemon=True).start()

    def _render_init_cluster_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Start Cluster', y=150)
        self._render_paragraph('Select a cluster environment and ensure Docker, K3D, OpenBao, and the local registry are running.', y=200)

        # Cluster Selection (Radio Buttons)
        x_label = 48
        y = 280
        self._canvas_items.append(ui.canvas_text(self, x_label, y, 'Select Cluster Name:', fill='black', font=('SF Pro Text', 14, 'bold')))
        
        y += 40
        cluster_options = [
            ('dev', 'prole-dev-cluster'),
            ('service', 'prole-service-cluster'),
            ('prod', 'prole-prod-cluster')
        ]
        
        for val, name in cluster_options:
            # Use tk.Radiobutton on canvas
            rb = tk.Radiobutton(self.bg_canvas, text=name, variable=self.cluster_env, value=val,
                               bg='white', fg='black', activebackground='white', selectcolor='white',
                               font=('SF Pro Text', 11))
            rb_window = self.bg_canvas.create_window(x_label+20, y, window=rb, anchor='nw')
            self._canvas_items.append(rb_window)
            self._overlay_widgets.append(rb)
            y += 32

        # Docker/K3D Status
        y += 30
        self.docker_status_label = ui.canvas_text(self, x_label, y, 'Docker: Checking...', fill='#6e6e73', font=('SF Pro Text', 12))
        self._canvas_items.append(self.docker_status_label)
        
        y += 30
        self.k3d_status_label = ui.canvas_text(self, x_label, y, 'K3D Cluster: Checking...', fill='#6e6e73', font=('SF Pro Text', 12))
        self._canvas_items.append(self.k3d_status_label)

        y += 30
        self.registry_status_label = ui.canvas_text(self, x_label, y, 'Local Registry: Checking...', fill='#6e6e73', font=('SF Pro Text', 12))
        self._canvas_items.append(self.registry_status_label)

        y += 30
        self.openbao_status_label = ui.canvas_text(self, x_label, y, 'OpenBao: Checking...', fill='#6e6e73', font=('SF Pro Text', 12))
        self._canvas_items.append(self.openbao_status_label)

        y += 50
        # Use tk.Button on canvas
        btn = tk.Button(self.bg_canvas, text='Start Cluster', command=self.ensure_cluster_ready,
                       bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                       highlightbackground='#F5F5DC', highlightthickness=0,
                       relief='flat', font=('SF Pro Text', 11), padx=16, pady=8)
        self._init_cluster_button = btn
        btn_window = self.bg_canvas.create_window(x_label, y, window=btn, anchor='nw', width=220)
        self._canvas_items.append(btn_window)
        self._overlay_widgets.append(btn)
        
        # Async status check
        self.check_cluster_status_async()

    def check_cluster_status_async(self):
        def worker():
            docker_ok = self.controller.check_docker_running()
            docker_msg = 'Docker: Running' if docker_ok else 'Docker: Not running'
            docker_fill = '#34c759' if docker_ok else '#ff3b30'
            
            cluster_name = f"prole-{self.cluster_env.get()}-cluster"
            res = subprocess.run(['k3d', 'cluster', 'list', '--no-headers'], capture_output=True, text=True)
            k3d_ok = cluster_name in res.stdout
            k3d_msg = f"K3D Cluster ({cluster_name}): Running" if k3d_ok else f"K3D Cluster ({cluster_name}): Not found/stopped"
            k3d_fill = '#34c759' if k3d_ok else '#ff9f0a'

            registry_ok = False
            openbao_ok = False
            openbao_name = os.environ.get("OPENBAO_NAME", "openbao")
            if docker_ok:
                try:
                    ps = subprocess.run(['docker', 'ps', '--format', '{{.Names}} {{.Image}}'], capture_output=True, text=True)
                    for line in (ps.stdout or '').splitlines():
                        parts = line.split()
                        if not parts:
                            continue
                        name = parts[0]
                        image = parts[1] if len(parts) > 1 else ''
                        if name == 'k3d-prole-registry' or image.startswith('registry:2'):
                            registry_ok = True
                        if name == openbao_name:
                            openbao_ok = True
                except Exception:
                    pass

            registry_msg = 'Local Registry: Running' if registry_ok else 'Local Registry: Not running'
            registry_fill = '#34c759' if registry_ok else '#ff9f0a'
            openbao_msg = 'OpenBao: Running' if openbao_ok else 'OpenBao: Not running'
            openbao_fill = '#34c759' if openbao_ok else '#ff9f0a'
            
            def update_ui():
                if hasattr(self, 'docker_status_label'):
                    self.bg_canvas.itemconfig(self.docker_status_label, text=docker_msg, fill=docker_fill)
                if hasattr(self, 'k3d_status_label'):
                    self.bg_canvas.itemconfig(self.k3d_status_label, text=k3d_msg, fill=k3d_fill)
                if hasattr(self, 'registry_status_label'):
                    self.bg_canvas.itemconfig(self.registry_status_label, text=registry_msg, fill=registry_fill)
                if hasattr(self, 'openbao_status_label'):
                    self.bg_canvas.itemconfig(self.openbao_status_label, text=openbao_msg, fill=openbao_fill)
                if hasattr(self, '_init_cluster_button'):
                    label = 'Verify Cluster' if k3d_ok else 'Start Cluster'
                    try:
                        self._init_cluster_button.configure(text=label)
                    except Exception:
                        pass
            
            self.root.after(0, update_ui)
            
        threading.Thread(target=worker, daemon=True).start()

    def ensure_cluster_ready(self):
        self._action_flags['init_cluster.start_cluster'] = True
        # Implementation of cluster creation/startup
        def worker():
            # 1. Start Docker if not running
            if not self.controller.check_docker_running():
                # Attempt to start Docker on macOS
                subprocess.run(['open', '-a', 'Docker'], capture_output=True)
                # Wait for it to start
                for _ in range(30):
                    time.sleep(2)
                    if self.controller.check_docker_running():
                        break
            
            if not self.controller.check_docker_running():
                self.root.after(0, lambda: messagebox.showerror('Docker', 'Could not start Docker. Please start it manually.'))
                return

            # 2. Ensure OpenBao container is running (local-only)
            env = self._script_env_for_namespace((self.db_namespace.get() or '').strip())
            env["PROLE_DB_USER"] = self.db_username.get().strip()
            env["AT_REST_ENCRYPTION_ENABLED"] = _bool_str(self.at_rest_encryption_enabled.get())
            rc_openbao = self.controller.run_script("init_openbao.sh", args=["start"], env=env)
            if rc_openbao != 0:
                self.root.after(0, lambda: messagebox.showerror('OpenBao', f'Failed to start OpenBao (code {rc_openbao}).'))
                return

            # 3. Ensure local registry is available before cluster creation (dev only)
            if self.cluster_env.get() == 'dev':
                try:
                    reg_info = self.ensure_local_registry_available()
                except Exception:
                    reg_info = None
                if not reg_info:
                    self.root.after(0, lambda: messagebox.showerror('Registry', 'Local registry is not running. Please start the registry and try again.'))
                    return

            # 4. Manage K3D Cluster
            cluster_name = f"prole-{self.cluster_env.get()}-cluster"
            res = subprocess.run(['k3d', 'cluster', 'list', '--no-headers'], capture_output=True, text=True)
            if cluster_name not in res.stdout:
                # Create it
                # Default args based on README.md
                cmd = ['k3d', 'cluster', 'create', cluster_name, '-a', '2']
                if self.cluster_env.get() == 'service':
                     cmd += ['--registry-create', 'k8s-prole-org-registry:k8s.prole.org:5000', '--api-port', '10.0.0.205:6443']
                elif self.cluster_env.get() == 'dev':
                     reg_args = []
                     try:
                         if self.ensure_local_registry_available():
                             reg_args = ['--registry-use', 'k3d-prole-registry:5000']
                     except Exception:
                         reg_args = []
                     cmd += reg_args + ['--api-port', '0.0.0.0:6443']
                
                # Run in terminal or capture output? Let's use a console window later. 
                # For now, run it and update status.
                subprocess.run(cmd, capture_output=True)
            else:
                # Start it if it's stopped
                subprocess.run(['k3d', 'cluster', 'start', cluster_name], capture_output=True)
            
            self.check_cluster_status_async()
            self.root.after(0, lambda: messagebox.showinfo('Cluster', f'Cluster {cluster_name} is ready.'))
            
        threading.Thread(target=worker, daemon=True).start()

    def _render_init_db_build_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Build Database Image', y=150)
        self._render_paragraph('Building the prole-db Postgres image. This may take a few minutes.', y=200)

        # Local registry status (checked async)
        self._db_registry_status_label = ui.canvas_text(self, 48, 230, "Local Registry: Checking...", fill='#6e6e73', font=('SF Pro Text', 11))
        self._canvas_items.append(self._db_registry_status_label)
        
        # Output Console
        self._db_build_console = self._create_console_output(y=260, title="Build Output", width=900, height=520)
        
        # Use tk.Button
        self._db_build_button = tk.Button(self.bg_canvas, text='Start Build', command=self.run_db_build,
                       bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                       highlightbackground='#F5F5DC', highlightthickness=0,
                       relief='flat', font=('SF Pro Text', 11), padx=16, pady=8)
        btn_window = self.bg_canvas.create_window(48, 800, window=self._db_build_button, anchor='nw', width=180)
        self._canvas_items.append(btn_window)
        self._overlay_widgets.append(self._db_build_button)

        # Status Label
        self._db_build_status_label = ui.canvas_text(self, 240, 812, "", fill='black', font=('SF Pro Text', 12))
        self._canvas_items.append(self._db_build_status_label)

        # Ensure registry check runs when entering the screen
        self._ensure_db_build_registry_async()

    def _ensure_db_build_registry_async(self):
        def worker():
            try:
                if not self.check_docker_running():
                    self.safe_after(lambda: self.bg_canvas.itemconfig(self._db_registry_status_label, text="Local Registry: Docker not running", fill='#ff3b30') if self.bg_canvas.winfo_exists() else None)
                    return
                info = self.ensure_local_registry_available()
                if info:
                    host_registry, _cluster_registry = info
                    self.safe_after(lambda: self.bg_canvas.itemconfig(self._db_registry_status_label, text=f"Local Registry: {host_registry}", fill='#34c759') if self.bg_canvas.winfo_exists() else None)
                else:
                    self.safe_after(lambda: self.bg_canvas.itemconfig(self._db_registry_status_label, text="Local Registry: unavailable", fill='#ff3b30') if self.bg_canvas.winfo_exists() else None)
            except Exception as e:
                msg = f"Local Registry: error ({e})"
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._db_registry_status_label, text=msg, fill='#ff3b30') if self.bg_canvas.winfo_exists() else None)

        threading.Thread(target=worker, daemon=True).start()

    def safe_after(self, func, delay=0):
        """Run a function in the main thread if the root window still exists."""
        if not self.root or not self.root.winfo_exists():
            return

        def wrapper():
            try:
                if self.root and self.root.winfo_exists():
                    func()
            except (tk.TclError, RuntimeError):
                pass
        try:
            self.root.after(delay, wrapper)
        except (tk.TclError, RuntimeError):
            pass

    def run_db_build(self):
        self._action_flags['init_db_build.run_build'] = True
        def worker():
            self.safe_after(lambda: self._db_build_button.configure(state='disabled') if self._db_build_button.winfo_exists() else None)
            self.safe_after(lambda: self.bg_canvas.itemconfig(self._db_build_status_label, text="Building...", fill='blue') if self.bg_canvas.winfo_exists() and self._db_build_status_label in self.bg_canvas.find_all() else None)

            tag = self.get_prole_db_version()
            image_name = f"prole-db:{tag}"

            # Use $HOME/.prole/build for Docker build context
            # This avoids issues with PyInstaller's temporary _MEIPASS directory
            prole_home = Path.home() / ".prole"
            build_dir = prole_home / "build" / "prole-db"
            build_dir.mkdir(parents=True, exist_ok=True)

            # Copy prole-db directory to writable location
            source_dir = get_resource_path("prole-db")
            if source_dir.exists():
                import shutil
                # Remove old build dir and copy fresh
                if source_dir.resolve() != build_dir.resolve():
                    if build_dir.exists():
                        shutil.rmtree(build_dir)
                    shutil.copytree(source_dir, build_dir)

            cwd = build_dir
            
            # Fetch the generated public key
            pub_key = ""
            pub_key_path = Path.home() / ".ssh" / "id_prole_ed25519.pub"
            if pub_key_path.exists():
                pub_key = pub_key_path.read_text().strip()
            
            username = self.db_username.get()
            cmd = ['docker', 'build',
                   '--build-arg', f"PROLE_USER={username}",
                   '--build-arg', f"PROLE_SSH_PUB_KEY={pub_key}",
                   '-t', image_name, '.']
            
            self._db_build_console.clear()
            self._db_build_console.write(f"Building {image_name} in {cwd}...\n\n")
            
            proc = subprocess.Popen(cmd, cwd=cwd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True)
            while True:
                line = proc.stdout.readline()
                if not line and proc.poll() is not None:
                    break
                if line:
                    self._db_build_console.write(line)
            
            if proc.returncode == 0:
                self._db_build_console.write("\nBuild successful!\n")
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._db_build_status_label, text="Build successful! Importing...", fill='#34c759') if self.bg_canvas.winfo_exists() and self._db_build_status_label in self.bg_canvas.find_all() else None)
                self._db_built_success = True
                
                # Import to k3d
                cluster_name = f"prole-{self.cluster_env.get()}-cluster"
                self._db_build_console.write(f"Importing image to {cluster_name}...\n")
                subprocess.run(['k3d', 'image', 'import', image_name, '-c', cluster_name])
                self._db_build_console.write("Import complete.\n")
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._db_build_status_label, text="Build and Import complete.", fill='#34c759') if self.bg_canvas.winfo_exists() and self._db_build_status_label in self.bg_canvas.find_all() else None)
            else:
                self._db_build_console.write(f"\nBuild failed with code {proc.returncode}\n")
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._db_build_status_label, text=f"Build failed (code {proc.returncode})", fill='#ff3b30') if self.bg_canvas.winfo_exists() and self._db_build_status_label in self.bg_canvas.find_all() else None)

            self.safe_after(lambda: self._db_build_button.configure(state='normal') if self._db_build_button.winfo_exists() else None)
                
        threading.Thread(target=worker, daemon=True).start()

    def _render_init_password_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Database Creation', y=150)
        self._render_paragraph('Create a database namespace for this deployment. The namespace is treated as a single database with a name and one root password. An ed25519 SSH key will be generated and stored in OpenBao for root access.', y=200)
        
        x_label = 48
        x_field = 300
        y = 270

        # Database (namespace) name
        self._canvas_items.append(ui.canvas_text(self, x_label, y, 'Database Name (Namespace):', fill='black', font=('SF Pro Text', 12, 'bold')))

        ns_frame = tk.Frame(self.bg_canvas, bg='white', highlightbackground='#CCCCCC', highlightthickness=1, bd=0)
        ns_frame.pack_propagate(False)
        prefix_label = tk.Label(ns_frame, text=self._namespace_prefix(), fg='#9a9aa0', bg='white', font=('SF Pro Text', 11))
        vcmd = (self.root.register(self._validate_namespace_suffix), '%P')
        suffix_entry = tk.Entry(
            ns_frame,
            textvariable=self.db_namespace_suffix,
            bg='white',
            fg='black',
            insertbackground='black',
            highlightthickness=0,
            relief='flat',
            font=('SF Pro Text', 11),
            validate='key',
            validatecommand=vcmd
        )
        prefix_label.pack(side='left', padx=(8, 2))
        suffix_entry.pack(side='left', fill='both', expand=True, padx=(0, 8))
        ns_window = self.bg_canvas.create_window(x_field, y-12, window=ns_frame, anchor='nw', width=400, height=32)
        self._canvas_items.append(ns_window)
        self._overlay_widgets.append(ns_frame)
        self._overlay_widgets.append(prefix_label)
        self._overlay_widgets.append(suffix_entry)

        y += 42
        # Owner (local user)
        self.db_username.set(self.namespace_owner)
        self._canvas_items.append(ui.canvas_text(self, x_label, y, 'Owner:', fill='black', font=('SF Pro Text', 12, 'bold')))
        owner_entry = tk.Entry(self.bg_canvas, textvariable=self.db_username, bg='white', fg='black',
                               insertbackground='black', highlightbackground='#CCCCCC', highlightthickness=1,
                               relief='flat', font=('SF Pro Text', 11))
        owner_window = self.bg_canvas.create_window(x_field, y-12, window=owner_entry, anchor='nw', width=400, height=32)
        self._canvas_items.append(owner_window)
        self._overlay_widgets.append(owner_entry)

        y += 42
        self._canvas_items.append(ui.canvas_text(self, x_label, y, 'Root Password:', fill='black', font=('SF Pro Text', 12, 'bold')))
        # Use tk.Entry on canvas
        p1 = tk.Entry(self.bg_canvas, textvariable=self.db_password, show='*', bg='white', fg='black',
                     insertbackground='black', highlightbackground='#CCCCCC', highlightthickness=1, 
                     relief='flat', font=('SF Pro Text', 11))
        p1_window = self.bg_canvas.create_window(x_field, y-12, window=p1, anchor='nw', width=400, height=32)
        self._canvas_items.append(p1_window)
        self._overlay_widgets.append(p1)
        
        y += 42
        self._canvas_items.append(ui.canvas_text(self, x_label, y, 'Confirm:', fill='black', font=('SF Pro Text', 12, 'bold')))
        # Use tk.Entry on canvas
        p2 = tk.Entry(self.bg_canvas, textvariable=self.db_password_confirm, show='*', bg='white', fg='black',
                     insertbackground='black', highlightbackground='#CCCCCC', highlightthickness=1, 
                     relief='flat', font=('SF Pro Text', 11))
        p2_window = self.bg_canvas.create_window(x_field, y-12, window=p2, anchor='nw', width=400, height=32)
        self._canvas_items.append(p2_window)
        self._overlay_widgets.append(p2)

        y += 42
        self._canvas_items.append(ui.canvas_text(self, x_label, y, 'Host Port Forward:', fill='black', font=('SF Pro Text', 12, 'bold')))
        port_entry = tk.Entry(self.bg_canvas, textvariable=self.db_host_port, bg='white', fg='black',
                             insertbackground='black', highlightbackground='#CCCCCC', highlightthickness=1,
                             relief='flat', font=('SF Pro Text', 11))
        port_window = self.bg_canvas.create_window(x_field, y-12, window=port_entry, anchor='nw', width=100, height=32)
        self._canvas_items.append(port_window)
        self._overlay_widgets.append(port_entry)

        # Indicator for password match (X or ✓)
        self.password_indicator = ui.canvas_text(self, x_field + 410, y, '✘', fill='#dc3545', font=('SF Pro Text', 16, 'bold'), state='hidden')
        self._canvas_items.append(self.password_indicator)

        # Optional Features moved above browser
        y += 50
        self._canvas_items.append(ui.canvas_text(self, x_label, y, 'Optional Features:', fill='black', font=('SF Pro Text', 13, 'bold')))
        
        feature_options = [
            ('Enable Supabase', self.supabase_enabled),
            ('Enable Kerberos Authentication', self.kerberos_enabled),
            ('Enable At-Rest Encryption', self.at_rest_encryption_enabled),
        ]

        fx = x_label + 20
        fy = y + 36
        for label, var in feature_options:
            cb = tk.Checkbutton(self.bg_canvas, text=label, variable=var,
                                bg='white', fg='black', activebackground='white',
                                selectcolor='white', font=('SF Pro Text', 11),
                                command=self._save_prole_cfg)
            cb_window = self.bg_canvas.create_window(fx, fy, window=cb, anchor='nw')
            self._canvas_items.append(cb_window)
            self._overlay_widgets.append(cb)
            fx += 280

        # Database browser
        table_y = fy + 50
        self._canvas_items.append(ui.canvas_text(self, x_label, table_y, 'Database Browser', fill='#1d1d1f', font=('SF Pro Text', 12, 'bold')))

        refresh_btn = tk.Button(self.bg_canvas, text='Refresh', command=self._refresh_namespace_table,
                                bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                                highlightbackground='#F5F5DC', highlightthickness=0,
                                relief='flat', font=('SF Pro Text', 10), padx=10, pady=4)
        refresh_window = self.bg_canvas.create_window(x_label + 160, table_y - 8, window=refresh_btn, anchor='nw')
        self._canvas_items.append(refresh_window)
        self._overlay_widgets.append(refresh_btn)

        add_btn = tk.Button(self.bg_canvas, text='Add', command=self._db_add_namespace,
                            bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                            highlightbackground='#F5F5DC', highlightthickness=0,
                            relief='flat', font=('SF Pro Text', 10), padx=10, pady=4)
        add_window = self.bg_canvas.create_window(x_label + 240, table_y - 8, window=add_btn, anchor='nw')
        self._canvas_items.append(add_window)
        self._overlay_widgets.append(add_btn)

        edit_btn = tk.Button(self.bg_canvas, text='Edit', command=self._db_edit_namespace,
                             bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                             highlightbackground='#F5F5DC', highlightthickness=0,
                             relief='flat', font=('SF Pro Text', 10), padx=10, pady=4)
        edit_window = self.bg_canvas.create_window(x_label + 300, table_y - 8, window=edit_btn, anchor='nw')
        self._canvas_items.append(edit_window)
        self._overlay_widgets.append(edit_btn)

        delete_btn = tk.Button(self.bg_canvas, text='Delete', command=self._db_delete_namespace,
                               bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                               highlightbackground='#F5F5DC', highlightthickness=0,
                               relief='flat', font=('SF Pro Text', 10), padx=10, pady=4)
        delete_window = self.bg_canvas.create_window(x_label + 360, table_y - 8, window=delete_btn, anchor='nw')
        self._canvas_items.append(delete_window)
        self._overlay_widgets.append(delete_btn)

        self._db_action_buttons = [refresh_btn, add_btn, edit_btn, delete_btn]

        table_frame = tk.Frame(self.bg_canvas, bg='white', highlightbackground='#E0E0E0', highlightthickness=1)
        table_window = self.bg_canvas.create_window(x_label, table_y + 30, window=table_frame, anchor='nw', width=900, height=180)
        self._canvas_items.append(table_window)
        self._overlay_widgets.append(table_frame)

        columns = ('select', 'name', 'owner', 'port', 'created', 'status')
        tree = ttk.Treeview(table_frame, columns=columns, show='headings', height=5)
        tree.heading('select', text='Select')
        tree.heading('name', text='Name')
        tree.heading('owner', text='Owner')
        tree.heading('port', text='Host Port')
        tree.heading('created', text='Creation Date')
        tree.heading('status', text='Status')
        tree.column('select', width=60, anchor='center')
        tree.column('name', width=180, anchor='w')
        tree.column('owner', width=140, anchor='w')
        tree.column('port', width=80, anchor='center')
        tree.column('created', width=200, anchor='w')
        tree.column('status', width=120, anchor='center')
        tree.pack(side='left', fill='both', expand=True)

        scroll = ttk.Scrollbar(table_frame, orient='vertical', command=tree.yview)
        tree.configure(yscrollcommand=scroll.set)
        scroll.pack(side='right', fill='y')

        self._overlay_widgets.append(tree)
        self._overlay_widgets.append(scroll)
        self._db_namespace_tree = tree

        def on_select(event):
            if getattr(self, '_refreshing_ns_table', False):
                return
            sel = tree.selection()
            if sel:
                vals = tree.item(sel[0], 'values')
                if vals:
                    ns = vals[1]
                    if ns == 'supabase':
                        # Do not allow selecting 'supabase' as the primary prole-db namespace
                        return
                    if ns == self.db_namespace.get():
                        # Already selected, don't trigger re-refresh/save
                        return
                    self.db_namespace.set(ns)
                    self._sync_namespace_suffix_from_full()
                    # Mark as selected in tree visually if needed, but we use the checkbox column
                    self._refresh_namespace_table()
                    self._save_prole_cfg()

        tree.bind('<<TreeviewSelect>>', on_select)

        self._db_namespace_note = ui.canvas_text(self, x_label, table_y + 220, '', fill='#6e6e73', font=('SF Pro Text', 10))
        self._canvas_items.append(self._db_namespace_note)

        def on_password_change(*args):
            p = self.db_password.get()
            c = self.db_password_confirm.get()
            
            if not p:
                self.bg_canvas.itemconfigure(self.password_indicator, state='hidden')
            elif p == c:
                self.bg_canvas.itemconfigure(self.password_indicator, text='✓', fill='#28a745', state='normal')
            else:
                self.bg_canvas.itemconfigure(self.password_indicator, text='✘', fill='#dc3545', state='normal')
        
        self.db_password.trace_add('write', on_password_change)
        self.db_password_confirm.trace_add('write', on_password_change)
        # Trigger once in case they are already set
        on_password_change()

        self._refresh_namespace_table()

    def _render_init_cnpg_deploy_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Deploy CloudNative-PG', y=150)
        self._render_paragraph('Deploying the CloudNative-PG operator and cluster manifests to Kubernetes.', y=200)
        
        # Output Console
        self._cnpg_deploy_console = self._create_console_output(y=260, title="Deployment Output", width=900, height=520)
        
        # Use tk.Button
        self._cnpg_deploy_button = tk.Button(self.bg_canvas, text='Run Deployment', command=self.run_cnpg_deploy,
                       bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                       highlightbackground='#F5F5DC', highlightthickness=0,
                       relief='flat', font=('SF Pro Text', 11), padx=16, pady=8)
        btn_window = self.bg_canvas.create_window(48, 800, window=self._cnpg_deploy_button, anchor='nw', width=180)
        self._canvas_items.append(btn_window)
        self._overlay_widgets.append(self._cnpg_deploy_button)

        # Force Rollout Button
        self._cnpg_rollout_button = tk.Button(self.bg_canvas, text='Force Rollout', command=self.run_cnpg_rollout,
                       bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                       highlightbackground='#F5F5DC', highlightthickness=0,
                       relief='flat', font=('SF Pro Text', 11), padx=16, pady=8)
        rollout_btn_window = self.bg_canvas.create_window(240, 800, window=self._cnpg_rollout_button, anchor='nw', width=160)
        self._canvas_items.append(rollout_btn_window)
        self._overlay_widgets.append(self._cnpg_rollout_button)

        # Status Label
        self._cnpg_deploy_status_label = ui.canvas_text(self, 420, 812, "", fill='black', font=('SF Pro Text', 12))
        self._canvas_items.append(self._cnpg_deploy_status_label)

    def run_cnpg_deploy(self):
        self._action_flags['init_cnpg_deploy.run_deploy'] = True
        def worker():
            self.safe_after(lambda: self._cnpg_deploy_button.configure(state='disabled') if self._cnpg_deploy_button.winfo_exists() else None)
            self.safe_after(lambda: self.bg_canvas.itemconfig(self._cnpg_deploy_status_label, text="Deploying...", fill='blue') if self.bg_canvas.winfo_exists() else None)

            etc_dir = PROJECT_ROOT / "etc"
            # Prepare environment for scripts
            env = os.environ.copy()
            env["PROLE_HOME"] = str(PROJECT_ROOT)
            env["PROLE_SERVICE"] = str(PROJECT_ROOT)
            env["NAMESPACE"] = (self.db_namespace.get() or '').strip()
            env["NAMESPACE"] = (self.db_namespace.get() or '').strip()
            
            self._cnpg_deploy_console.clear()
            self._cnpg_deploy_console.write("Starting CloudNative-PG deployment...\n")
            self._cnpg_deploy_console.write("> bash etc/init_prole-db.sh deploy latest\n\n")
            
            proc = subprocess.Popen(['bash', str(etc_dir / 'init_prole-db.sh'), 'deploy', 'latest'], 
                                   stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True, env=env)
            
            while True:
                line = proc.stdout.readline()
                if not line and proc.poll() is not None:
                    break
                if line:
                    self._cnpg_deploy_console.write(line)
            
            if proc.returncode == 0:
                self._cnpg_deploy_console.write("\nDeployment successful!\n")
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._cnpg_deploy_status_label, text="Deployment successful!", fill='#34c759') if self.bg_canvas.winfo_exists() else None)
                self._cnpg_success = True
            else:
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._cnpg_deploy_status_label, text=f"Deployment failed (code {proc.returncode})", fill='#ff3b30') if self.bg_canvas.winfo_exists() else None)
                self._cnpg_success = False

            self.safe_after(lambda: self._cnpg_deploy_button.configure(state='normal') if self._cnpg_deploy_button.winfo_exists() else None)
                
        threading.Thread(target=worker, daemon=True).start()

    def run_cnpg_rollout(self):
        self._action_flags['init_cnpg_deploy.force_rollout'] = True
        def worker():
            self.safe_after(lambda: self._cnpg_deploy_button.configure(state='disabled') if self._cnpg_deploy_button.winfo_exists() else None)
            self.safe_after(lambda: self._cnpg_rollout_button.configure(state='disabled') if self._cnpg_rollout_button.winfo_exists() else None)
            self.safe_after(lambda: self.bg_canvas.itemconfig(self._cnpg_deploy_status_label, text="Rolling out...", fill='blue') if self.bg_canvas.winfo_exists() else None)

            etc_dir = PROJECT_ROOT / "etc"
            # Prepare environment for scripts
            env = os.environ.copy()
            env["PROLE_HOME"] = str(PROJECT_ROOT)
            env["PROLE_SERVICE"] = str(PROJECT_ROOT)
            
            self._cnpg_deploy_console.clear()
            self._cnpg_deploy_console.write("Starting manual recreate rollout for prole-db cluster...\n")
            self._cnpg_deploy_console.write("> bash etc/init_prole-db.sh rollout\n\n")
            
            proc = subprocess.Popen(['bash', str(etc_dir / 'init_prole-db.sh'), 'rollout'], 
                                   stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True, env=env)
            
            while True:
                line = proc.stdout.readline()
                if not line and proc.poll() is not None:
                    break
                if line:
                    self._cnpg_deploy_console.write(line)
            
            if proc.returncode == 0:
                self._cnpg_deploy_console.write("\nRollout successful!\n")
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._cnpg_deploy_status_label, text="Rollout successful!", fill='#34c759') if self.bg_canvas.winfo_exists() else None)
            else:
                self._cnpg_deploy_console.write(f"\nRollout failed with code {proc.returncode}\n")
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._cnpg_deploy_status_label, text=f"Rollout failed (code {proc.returncode})", fill='#ff3b30') if self.bg_canvas.winfo_exists() else None)

            self.safe_after(lambda: self._cnpg_deploy_button.configure(state='normal') if self._cnpg_deploy_button.winfo_exists() else None)
            self.safe_after(lambda: self._cnpg_rollout_button.configure(state='normal') if self._cnpg_rollout_button.winfo_exists() else None)

    def _init_scripts_list(self):
        scripts = [
            ('Kubectl Status', self.KUBECTL_STATUS_TAB),
            ('Garage Store', 'init_garage_store.sh'),
            ('Garage Log', 'garage_log'),
            ('CloudNative-PG', 'init_cloudnative_pg.sh'),
        ]
        if self.kerberos_enabled.get():
            scripts.append(('Kerberos Realm', 'init_kerberos.sh'))
        scripts.extend([
            ('Prole DB', 'init_prole-db.sh'),
            ('Prole DB Backup', 'init_prole-db-backup.sh'),
            ('Monitoring', 'init_monitoring.sh'),
            ('Port Forwards', 'init_port_forwards.sh'),
        ])
        return scripts

    def _render_init_scripts_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Initialization Scripts', y=150)
        self._render_paragraph('Running initialization scripts to set up Garage, CloudNative-PG, and backups.', y=200)
        
        # Tabs for output - using standardized appearance
        ui.canvas_text(self, 48, 260, "Execution Output", fill='#1d1d1f', font=('SF Pro Text', 12, 'bold'))
        
        # Use a background frame for the notebook to hide potential system borders
        notebook_bg = tk.Frame(self.bg_canvas, bg='white', highlightthickness=0, bd=0)
        self.script_tabs = ttk.Notebook(notebook_bg, style='TNotebook')
        self.script_tabs.pack(fill='both', expand=True, padx=1, pady=1)
        
        tab_window = self.bg_canvas.create_window(48, 290, window=notebook_bg, anchor='nw', width=900, height=450)
        self._canvas_items.append(tab_window)
        self._overlay_widgets.append(notebook_bg)
        self._overlay_widgets.append(self.script_tabs)
        
        self.script_consoles = {}
        scripts = self._init_scripts_list()
        self._script_tab_index = {}
        
        for idx, (title, fname) in enumerate(scripts):
            # Use a background frame to ensure NO borders are visible around the console
            console_bg = tk.Frame(self.script_tabs, bg='white', highlightthickness=0, bd=0)
            self.script_tabs.add(console_bg, text=title)
            # Use TerminalConsole for consistent styling
            if fname == self.KUBECTL_STATUS_TAB:
                mono = ('Menlo', 9) if platform.system() == 'Darwin' else ('Consolas', 9)
                console = ui.TerminalConsole(console_bg, highlightthickness=0, bd=0, font=mono, wrap='none', show_horizontal=True)
            else:
                console = ui.TerminalConsole(console_bg, highlightthickness=0, bd=0)
            console.pack(fill='both', expand=True, padx=1, pady=1)
            self.script_consoles[fname] = console
            self._script_tab_index[fname] = idx

        self.script_tabs.bind("<<NotebookTabChanged>>", self._on_init_scripts_tab_changed)
        self.safe_after(self._refresh_kubectl_status_tab, delay=50)

        # Use tk.Button
        self._init_scripts_button = tk.Button(self.bg_canvas, text='Run Scripts', command=self.run_init_scripts,
                       bg='#F5F5DC', fg='black', activebackground='#E5E5D5',
                       highlightbackground='#F5F5DC', highlightthickness=0,
                       relief='flat', font=('SF Pro Text', 11), padx=16, pady=8)
        btn_window = self.bg_canvas.create_window(48, 760, window=self._init_scripts_button, anchor='nw', width=180)
        self._canvas_items.append(btn_window)
        self._overlay_widgets.append(self._init_scripts_button)
        
        # Status Label
        self._init_scripts_status_label = ui.canvas_text(self, 240, 772, "", fill='black', font=('SF Pro Text', 12))
        self._canvas_items.append(self._init_scripts_status_label)

    def _on_init_scripts_tab_changed(self, _event=None):
        try:
            current_idx = self.script_tabs.index("current")
        except Exception:
            return
        if current_idx == self._script_tab_index.get(self.KUBECTL_STATUS_TAB):
            self._refresh_kubectl_status_tab()

    def _refresh_kubectl_status_tab(self):
        console = self.script_consoles.get(self.KUBECTL_STATUS_TAB)
        if not console:
            return

        namespace = (self.db_namespace.get() or '').strip() or os.environ.get('NAMESPACE') or 'default'

        def _run_shell(command: str):
            env = os.environ.copy()
            env.setdefault("PROLE_HOME", str(PROJECT_ROOT))
            try:
                res = subprocess.run(['/bin/bash', '-lc', command], capture_output=True, text=True, env=env)
                out = res.stdout or ""
                err = res.stderr or ""
                return res.returncode, out, err
            except Exception as exc:
                return 1, "", f"{exc}"

        def worker():
            code, out, err = _run_shell("kubectl get pods -A -o wide")
            now = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
            header = f"# kubectl get pods -A -o wide ({now})  [highlight: namespace={namespace}]"

            lines = [ln.rstrip('\n') for ln in out.splitlines() if ln.strip() != ""]
            if code != 0 and not lines:
                lines = ["(no output)"]

            pod_rows = []
            unhappy = []
            if lines:
                for idx, line in enumerate(lines):
                    if idx == 0:
                        pod_rows.append({'raw': line, 'ns': '', 'unhappy': False})
                        continue
                    parts = line.split()
                    if len(parts) < 4:
                        pod_rows.append({'raw': line, 'ns': '', 'unhappy': False})
                        continue
                    ns, name, ready, status = parts[0], parts[1], parts[2], parts[3]

                    status_lc = status.lower()
                    happy_status = status_lc in ('running', 'completed', 'succeeded')
                    ready_ok = True
                    if status_lc == 'running' and '/' in ready:
                        try:
                            a, b = ready.split('/', 1)
                            ready_ok = (a == b)
                        except Exception:
                            ready_ok = False

                    is_happy = happy_status and (ready_ok or status_lc in ('completed', 'succeeded'))
                    if not is_happy:
                        unhappy.append({'ns': ns, 'name': name, 'status': status, 'ready': ready})

                    pod_rows.append({'raw': line, 'ns': ns, 'unhappy': not is_happy})

            details = ""
            if unhappy:
                blocks = ["", "# Unhealthy pods detected; collecting events + logs"]
                for pod in unhappy:
                    ns = pod['ns']
                    name = pod['name']
                    blocks.append(f"\n## Events for {ns}/{name}")
                    ec, eout, eerr = _run_shell(
                        f"kubectl get events -n {shlex.quote(ns)} "
                        f"--field-selector involvedObject.kind=Pod,involvedObject.name={shlex.quote(name)} "
                        f"--sort-by=.lastTimestamp"
                    )
                    blocks.append(eout.strip() or eerr.strip() or "(no events output)")

                    blocks.append(f"\n## Logs for {ns}/{name}")
                    lc, lout, lerr = _run_shell(
                        f"kubectl logs -n {shlex.quote(ns)} {shlex.quote(name)} --all-containers --tail=200"
                    )
                    blocks.append(lout.strip() or lerr.strip() or "(no logs output)")

                details = "\n".join(blocks).rstrip() + "\n"
            elif err.strip():
                details = "\n# kubectl stderr\n" + err.strip() + "\n"

            def render():
                if not console.text.winfo_exists():
                    return
                text = console.text
                text.configure(state='normal')
                text.delete('1.0', 'end')
                text.tag_configure('header', foreground='#6e6e73')
                text.tag_configure('ns', background='#DDF4FF')
                text.tag_configure('bad', foreground='#B00020')

                text.insert('end', header + "\n\n", ('header',))
                for row in pod_rows:
                    tags = []
                    if row['ns'] == namespace:
                        tags.append('ns')
                    if row['unhappy']:
                        tags.append('bad')
                    if row['raw'].strip():
                        text.insert('end', row['raw'] + "\n", tuple(tags))
                if details:
                    text.insert('end', "\n" + details)
                text.see('1.0')
                text.configure(state='disabled')

            self.safe_after(render)

        threading.Thread(target=worker, daemon=True).start()

    def run_init_scripts(self):
        self._action_flags['init_scripts.run_scripts'] = True
        def worker():
            def _select_tab(script_name):
                idx = getattr(self, '_script_tab_index', {}).get(script_name)
                if idx is None:
                    return
                self.safe_after(lambda: self.script_tabs.select(idx) if self.script_tabs.winfo_exists() else None)

            self.safe_after(lambda: self._init_scripts_button.configure(state='disabled') if self._init_scripts_button.winfo_exists() else None)
            self.safe_after(lambda: self.bg_canvas.itemconfig(self._init_scripts_status_label, text="Running scripts...", fill='blue') if self.bg_canvas.winfo_exists() else None)

            password = self.db_password.get()
            
            # Prepare environment for scripts
            env = os.environ.copy()
            env["PROLE_HOME"] = str(PROJECT_ROOT)
            env["PROLE_SERVICE"] = str(PROJECT_ROOT)
            env["PROLE_DB_USER"] = self.db_username.get()
            env["DB_PASSWORD"] = password
            env["NAMESPACE"] = (self.db_namespace.get() or '').strip()
            if self.kerberos_realm.get().strip():
                env["KRB5_REALM"] = self.kerberos_realm.get().strip()
                env["REALM"] = self.kerberos_realm.get().strip()
                env["DOMAIN"] = self.kerberos_realm.get().strip().lower()
            if self.kerberos_kdc.get().strip():
                env["KRB5_KDC"] = self.kerberos_kdc.get().strip()
                env["KRB5_ADMIN"] = self.kerberos_kdc.get().strip()
            if self.kerberos_user.get().strip():
                env["KRB5_USER"] = self.kerberos_user.get().strip()
            if self.kerberos_password.get().strip():
                env["KRB5_PASSWORD"] = self.kerberos_password.get().strip()
            env.setdefault("KRB5_AD_PORT_FORWARD", "1")

            logs_dir = self._resolve_prole_logs_dir()
            try:
                logs_dir.mkdir(parents=True, exist_ok=True)
            except Exception:
                pass
            env.setdefault("PROLE_LOGS", str(logs_dir))

            def _log_path_for(script_name: str) -> Path:
                base = Path(script_name).stem
                if base in ('garage_log', 'init_garage_store'):
                    return logs_dir / 'init_garage_store.log'
                return logs_dir / f'{base}.log'

            # 0. Pre-emptive stop for port-forwards to avoid conflicts on re-install
            script_pf = "init_port_forwards.sh"
            if script_pf in self.script_consoles:
                self.script_consoles[script_pf].write("Stopping existing port-forwards to avoid conflicts...\n")
                self.controller.run_script(
                    script_pf,
                    args=['stop'],
                    env=env
                )

            # 1. init_garage_store.sh start
            overall_success = True
            if overall_success:
                script = "init_garage_store.sh"
                _select_tab(script)
                self.script_consoles[script].clear()
                self.script_consoles[script].write(f"Running {script} start...\n")

                garage_log_path = _log_path_for(script)
                env["GARAGE_INIT_LOG"] = str(garage_log_path)
                self._record_install_log(garage_log_path)
                self.script_consoles["garage_log"].clear()
                self.script_consoles["garage_log"].write(f"Log file: {garage_log_path}\n\n")
                self.script_consoles[script].write(f"Log file: {garage_log_path}\n\n")

                try:
                    garage_fp = garage_log_path.open('a', encoding='utf-8')
                except Exception:
                    garage_fp = None

                def _garage_line(line):
                    self.script_consoles[script].write(line)
                    self.script_consoles["garage_log"].write(line)
                    if garage_fp:
                        try:
                            garage_fp.write(line)
                            garage_fp.flush()
                        except Exception:
                            pass

                rc_garage = self.controller.run_script(
                    script,
                    args=['start'],
                    env=env,
                    on_line=_garage_line
                )
                if garage_fp:
                    try:
                        garage_fp.close()
                    except Exception:
                        pass

                if rc_garage != 0:
                    self.script_consoles[script].write(f"\nERROR: {script} start failed with code {rc_garage}\n")
                    overall_success = False
                else:
                    self.script_consoles[script].write(f"\n{script} completed successfully.\n")
            else:
                self.script_consoles["init_garage_store.sh"].write("Skipping Garage initialization because previous steps failed.\n")

            # 2. init_cloudnative_pg.sh initialize
            if overall_success:
                script = "init_cloudnative_pg.sh"
                _select_tab(script)
                self.script_consoles[script].clear()
                self.script_consoles[script].write(f"Running {script} initialize...\n")
                self.script_consoles[script].write("> bash etc/init_cloudnative_pg.sh initialize\n")

                log_path = _log_path_for(script)
                self._record_install_log(log_path)
                try:
                    log_fp = log_path.open('a', encoding='utf-8')
                except Exception:
                    log_fp = None

                def _cnpg_line(line):
                    self.script_consoles[script].write(line)
                    if log_fp:
                        try:
                            log_fp.write(line)
                            log_fp.flush()
                        except Exception:
                            pass

                rc2 = self.controller.run_script(
                    script,
                    args=['initialize'],
                    env=env,
                    on_line=_cnpg_line
                )
                if log_fp:
                    try:
                        log_fp.close()
                    except Exception:
                        pass

                if rc2 != 0:
                    self.script_consoles[script].write(f"\nERROR: {script} initialize failed with code {rc2}\n")
                    overall_success = False
                else:
                    self.script_consoles[script].write(f"\n{script} completed successfully.\n")
            else:
                if "init_cloudnative_pg.sh" in self.script_consoles:
                    self.script_consoles["init_cloudnative_pg.sh"].write("Skipping CloudNative-PG initialization because previous steps failed.\n")

            # 3. init_kerberos.sh initialize (optional)
            if overall_success and self.kerberos_enabled.get():
                script = "init_kerberos.sh"
                if script in self.script_consoles:
                    _select_tab(script)
                    self.script_consoles[script].clear()
                    self.script_consoles[script].write(f"Running {script} initialize...\n")

                    log_path = _log_path_for(script)
                    self._record_install_log(log_path)
                    try:
                        log_fp = log_path.open('a', encoding='utf-8')
                    except Exception:
                        log_fp = None

                    def _krb_line(line):
                        self.script_consoles[script].write(line)
                        if log_fp:
                            try:
                                log_fp.write(line)
                                log_fp.flush()
                            except Exception:
                                pass

                    rc_krb = self.controller.run_script(
                        script,
                        args=['initialize'],
                        env=env,
                        on_line=_krb_line
                    )
                    if log_fp:
                        try:
                            log_fp.close()
                        except Exception:
                            pass

                    if rc_krb != 0:
                        self.script_consoles[script].write(f"\nERROR: {script} initialize failed with code {rc_krb}\n")
                        overall_success = False
                    else:
                        self.script_consoles[script].write(f"\n{script} completed successfully.\n")
                else:
                    fallback_console = self.script_consoles.get("init_cloudnative_pg.sh")
                    if fallback_console:
                        fallback_console.write("Kerberos init console missing; skipping.\n")
            elif not self.kerberos_enabled.get():
                if "init_kerberos.sh" in self.script_consoles:
                    self.script_consoles["init_kerberos.sh"].write("Kerberos auth disabled; skipping init_kerberos.sh.\n")
            # 6. init_prole-db.sh start
            if overall_success:
                script = "init_prole-db.sh"
                _select_tab(script)
                self.script_consoles[script].clear()
                self.script_consoles[script].write(f"Running {script} start...\n")

                log_path = _log_path_for(script)
                self._record_install_log(log_path)
                try:
                    log_fp = log_path.open('a', encoding='utf-8')
                except Exception:
                    log_fp = None

                def _db_line(line):
                    self.script_consoles[script].write(line)
                    if log_fp:
                        try:
                            log_fp.write(line)
                            log_fp.flush()
                        except Exception:
                            pass

                rc_db = self.controller.run_script(
                    script,
                    args=['start'],
                    env=env,
                    on_line=_db_line
                )
                if log_fp:
                    try:
                        log_fp.close()
                    except Exception:
                        pass

                if rc_db != 0:
                    self.script_consoles[script].write(f"\nERROR: {script} start failed with code {rc_db}\n")
                    overall_success = False
                else:
                    self.script_consoles[script].write(f"\n{script} completed successfully.\n")
            else:
                self.script_consoles["init_prole-db.sh"].write("Skipping Prole DB initialization because previous steps failed.\n")

            # 7. init_prole-db-backup.sh start
            if overall_success:
                script = "init_prole-db-backup.sh"
                _select_tab(script)
                self.script_consoles[script].clear()
                self.script_consoles[script].write(f"Running {script} start...\n")

                log_path = _log_path_for(script)
                self._record_install_log(log_path)
                try:
                    log_fp = log_path.open('a', encoding='utf-8')
                except Exception:
                    log_fp = None

                def _backup_line(line):
                    self.script_consoles[script].write(line)
                    if log_fp:
                        try:
                            log_fp.write(line)
                            log_fp.flush()
                        except Exception:
                            pass

                rc_backup = self.controller.run_script(
                    script,
                    args=['start'],
                    env=env,
                    on_line=_backup_line
                )
                if log_fp:
                    try:
                        log_fp.close()
                    except Exception:
                        pass

                if rc_backup != 0:
                    self.script_consoles[script].write(f"\nERROR: {script} start failed with code {rc_backup}\n")
                    overall_success = False
                else:
                    self.script_consoles[script].write(f"\n{script} completed successfully.\n")
            else:
                self.script_consoles["init_prole-db-backup.sh"].write("Skipping Prole DB backup because previous steps failed.\n")

            # 8. init_monitoring.sh initialize
            if overall_success:
                script = "init_monitoring.sh"
                _select_tab(script)
                self.script_consoles[script].clear()
                self.script_consoles[script].write(f"Running {script} initialize...\n")
                
                log_path = _log_path_for(script)
                self._record_install_log(log_path)
                try:
                    log_fp = log_path.open('a', encoding='utf-8')
                except Exception:
                    log_fp = None

                def _monitoring_line(line):
                    self.script_consoles[script].write(line)
                    if log_fp:
                        try:
                            log_fp.write(line)
                            log_fp.flush()
                        except Exception:
                            pass
                    # Extract Grafana password if present
                    if "GRAFANA_ADMIN_PASSWORD=" in line:
                        pwd = line.split("GRAFANA_ADMIN_PASSWORD=")[1].strip()
                        if pwd:
                            self.prole_cfg_data['Monitoring'] = {'GRAFANA_ADMIN_PASSWORD': pwd}
                            self._save_prole_cfg()

                rc_mon = self.controller.run_script(
                    script,
                    args=['initialize'],
                    env=env,
                    on_line=_monitoring_line
                )
                if log_fp:
                    try:
                        log_fp.close()
                    except Exception:
                        pass

                if rc_mon != 0:
                    self.script_consoles[script].write(f"\nERROR: {script} initialize failed with code {rc_mon}\n")
                    overall_success = False
                else:
                    self.script_consoles[script].write(f"\n{script} completed successfully.\n")
            else:
                if "init_monitoring.sh" in self.script_consoles:
                    self.script_consoles["init_monitoring.sh"].write("Skipping Monitoring initialization because previous steps failed.\n")

            # 9. init_port_forwards.sh start
            if overall_success:
                script = "init_port_forwards.sh"
                _select_tab(script)
                self.script_consoles[script].clear()
                self.script_consoles[script].write(f"Running {script} start...\n")
                log_path = _log_path_for(script)
                self._record_install_log(log_path)
                try:
                    log_fp = log_path.open('a', encoding='utf-8')
                except Exception:
                    log_fp = None

                def _pf_line(line):
                    self.script_consoles[script].write(line)
                    if log_fp:
                        try:
                            log_fp.write(line)
                            log_fp.flush()
                        except Exception:
                            pass

                rc_pf = self.controller.run_script(
                    script,
                    args=['start'],
                    env=env,
                    on_line=_pf_line
                )
                if log_fp:
                    try:
                        log_fp.close()
                    except Exception:
                        pass
                if rc_pf != 0:
                     self.script_consoles[script].write(f"\nERROR: {script} start failed with code {rc_pf}\n")
                     overall_success = False
                else:
                    self.script_consoles[script].write(f"\n{script} completed successfully.\n")
            else:
                self.script_consoles["init_port_forwards.sh"].write("Skipping Port Forwards because previous steps failed.\n")

            if overall_success:
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._init_scripts_status_label, text="Initialization complete!", fill='#34c759') if self.bg_canvas.winfo_exists() else None)
                self._scripts_success = True
            else:
                self.safe_after(lambda: self.bg_canvas.itemconfig(self._init_scripts_status_label, text="Initialization failed.", fill='#ff3b30') if self.bg_canvas.winfo_exists() else None)
                self._scripts_success = False
            
            self.safe_after(lambda: self.update_footer())
            self.safe_after(lambda: self._init_scripts_button.configure(state='normal') if self._init_scripts_button.winfo_exists() else None)
                
        threading.Thread(target=worker, daemon=True).start()

    def get_removable_disks(self):
        """Detect removable media on macOS using diskutil."""
        self.removable_disks = []
        if platform.system() != 'Darwin':
            return self.removable_disks

        try:
            # Get list of all disks
            res = subprocess.run(['diskutil', 'list', '-plist'], capture_output=True, text=True)
            if res.returncode != 0:
                return []

            import plistlib
            data = plistlib.loads(res.stdout.encode())
            all_disks = data.get('AllDisks', [])

            for disk in all_disks:
                # Filter for whole disks to check if they are removable
                if not disk.startswith('disk') or 's' in disk:
                    continue
                
                info_res = subprocess.run(['diskutil', 'info', '-plist', disk], capture_output=True, text=True)
                if info_res.returncode == 0:
                    info = plistlib.loads(info_res.stdout.encode())
                    # Check for RemovableMedia or RemovableMediaOrExternalDevice
                    # Also check BusProtocol to catch most USB sticks if they don't report as removable
                    is_removable = (
                        info.get('RemovableMedia', False) or 
                        info.get('RemovableMediaOrExternalDevice', False) or
                        info.get('BusProtocol') in ['USB', 'FireWire', 'Thunderbolt']
                    )
                    
                    # Ensure it's not the internal system drive if we are using protocol as a hint
                    if info.get('Internal', False) and info.get('BusProtocol') not in ['USB']:
                        is_removable = False
                    
                    if is_removable:
                        # Found a removable disk, now find its mounted volumes
                        # We look for partitions of this disk that are mounted
                        for d2 in all_disks:
                            if d2.startswith(disk + 's'):
                                v_res = subprocess.run(['diskutil', 'info', '-plist', d2], capture_output=True, text=True)
                                if v_res.returncode == 0:
                                    v_info = plistlib.loads(v_res.stdout.encode())
                                    mount_point = v_info.get('MountPoint')
                                    volume_name = v_info.get('VolumeName') or v_info.get('DeviceIdentifier')
                                    if mount_point:
                                        self.removable_disks.append((volume_name, mount_point))
        except Exception as e:
            print(f"Error detecting disks: {e}")
        
        return self.removable_disks

    def _render_disk_selection_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Deployment Destination.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Select Destination', y=150)
        self._render_paragraph("Choose where you would like to deploy the built Prole application and its supporting artifacts.", y=210)

        # Container for the two main options
        y_options = 300
        x_center = content_width // 2
        
        # We need large friendly images. I'll use placeholders if I can't find specific ones.
        # But I'll try to use symbols or colors for now if images are missing.
        
        try:
            from PIL import Image, ImageTk
            # Using proleIcon.png as a placeholder for both for now, but I'll add distinct styling
            icon_path = PROJECT_ROOT / 'img' / 'proleIcon.png'
            icon_img = Image.open(str(icon_path)).resize((128, 128), Image.LANCZOS)
            self._disk_icon_tk = ImageTk.PhotoImage(icon_img)
        except Exception:
            self._disk_icon_tk = None

        # Option 1: Removable Disk
        frame_usb = tk.Frame(self.bg_canvas, bg='white', highlightthickness=1, highlightbackground='#CCCCCC', padx=20, pady=20)
        usb_window = self.bg_canvas.create_window(x_center - 250, y_options, window=frame_usb, anchor='n', width=350)
        self._overlay_widgets.append(frame_usb)
        self._canvas_items.append(usb_window)
        
        if self._disk_icon_tk:
            lbl_img_usb = tk.Label(frame_usb, image=self._disk_icon_tk, bg='white', cursor='hand2')
            lbl_img_usb.pack()
            lbl_img_usb.bind("<Button-1>", lambda e: self.selected_disk_type.set('removable'))
        
        tk.Radiobutton(frame_usb, text="USB / Flash Drive", variable=self.selected_disk_type, value='removable', 
                       bg='white', font=('SF Pro Text', 14, 'bold')).pack(pady=10)
        
        # Dropdown for removable disks
        disk_names = [d[0] for d in self.removable_disks] or ["No removable disks detected"]
        if not self.selected_removable_disk.get() and self.removable_disks:
            self.selected_removable_disk.set(self.removable_disks[0][1])
            
        self.disk_dropdown = ttk.Combobox(frame_usb, values=disk_names, state="readonly", width=30)
        self.disk_dropdown.pack(pady=5)
        if disk_names: self.disk_dropdown.current(0)
        
        def on_disk_select(event):
            idx = self.disk_dropdown.current()
            if idx >= 0 and idx < len(self.removable_disks):
                self.selected_removable_disk.set(self.removable_disks[idx][1])
                self.selected_disk_type.set('removable')
        
        self.disk_dropdown.bind("<<ComboboxSelected>>", on_disk_select)

        # Option 2: Local Folder
        frame_local = tk.Frame(self.bg_canvas, bg='white', highlightthickness=1, highlightbackground='#CCCCCC', padx=20, pady=20)
        local_window = self.bg_canvas.create_window(x_center + 250, y_options, window=frame_local, anchor='n', width=350)
        self._overlay_widgets.append(frame_local)
        self._canvas_items.append(local_window)

        if self._disk_icon_tk:
            lbl_img_local = tk.Label(frame_local, image=self._disk_icon_tk, bg='white', cursor='hand2')
            lbl_img_local.pack()
            lbl_img_local.bind("<Button-1>", lambda e: self.selected_disk_type.set('local'))

        tk.Radiobutton(frame_local, text="Local Filesystem", variable=self.selected_disk_type, value='local', 
                       bg='white', font=('SF Pro Text', 14, 'bold')).pack(pady=10)

        # Path input and browse
        path_frame = tk.Frame(frame_local, bg='white')
        path_frame.pack(fill='x', pady=5)
        
        ent_path = tk.Entry(path_frame, textvariable=self.selected_local_path, font=('SF Pro Text', 10), width=30)
        ent_path.pack(side='left', padx=(0, 5))
        
        def browse_local():
            from tkinter import filedialog
            d = filedialog.askdirectory(initialdir=self.selected_local_path.get())
            if d:
                self.selected_local_path.set(d)
                self.selected_disk_type.set('local')

        btn_browse = tk.Button(path_frame, text="Browse...", command=browse_local, bg='#F5F5DC')
        btn_browse.pack(side='left')

    def _render_build_page(self):
        # Letterhead at top right
        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48
        
        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73', 
                      font=('SF Pro Text', 18), anchor='ne')

        # Shifted up to accommodate radios and standard console position
        self._render_title('Build Prole Tools.app', y=80)
        self._render_paragraph('Build and prepare Prole Tools.app for deployment.', y=130)

        # Canvas-drawn radio buttons (no ttk widgets to avoid grey/white boxes)
        if not hasattr(self, 'deploy_env_value'):
            self.deploy_env_value = 'Dev'

        radio_y = 180
        left = 56
        spacing = 150

        # Draw three radio options
        self._build_radio_items = []
        options = [('Dev', left), ('Service', left + spacing), ('Prod', left + spacing * 2)]
        for label, x in options:
            # outer circle
            r = 10
            circle = ui.canvas_oval(self, x, radio_y, x + 2*r, radio_y + 2*r, outline='black', width=2)
            self._canvas_items.append(circle)
            # selected dot
            if self.deploy_env_value == label:
                dot = ui.canvas_oval(self, x+5, radio_y+5, x+2*r-5, radio_y+2*r-5, fill='black', outline='')
                self._canvas_items.append(dot)
            text = ui.canvas_text(self, x + 2*r + 10, radio_y - 2, label, fill='black', font=('SF Pro Text', 12))
            self._canvas_items.append(text)
            self._build_radio_items.append((label, circle, text))

        # Click handling for radio selection
        def _on_click(event):
            ex, ey = event.x, event.y
            for label, circle, text in self._build_radio_items:
                bbox_c = self.bg_canvas.bbox(circle)
                bbox_t = self.bg_canvas.bbox(text)
                hit = False
                if bbox_c and bbox_c[0] <= ex <= bbox_c[2] and bbox_c[1] <= ey <= bbox_c[3]:
                    hit = True
                if bbox_t and bbox_t[0] <= ex <= bbox_t[2] and bbox_t[1] <= ey <= bbox_t[3]:
                    hit = True
                if hit:
                    self.deploy_env_value = label
                    # Re-render only radios by re-drawing the page
                    self._clear_canvas_page()
                    self._render_build_page()
                    self.update_footer()
                    break
        self.bg_canvas.bind('<Button-1>', _on_click)

        # Output Console (Consistent size and location: y=260, width=900, height=520)
        self._build_console = self._create_console_output(y=230, title="Build Output", width=900, height=550)
        self._console_text = self._build_console.text # For compatibility with _append_console and others

        # Show a command preview with PS1-style prompt and blinking cursor
        preview = self._compose_build_preview()
        self._console_set_preview(preview)
        
        # Ensure state holders exist
        if not hasattr(self, 'last_build_log_path'):
            self.last_build_log_path = None
        # Update Next button label/state
        self.update_footer()
        # Bind Enter to trigger Build on this page
        def _enter_build(_evt=None):
            self.perform_build()
        try:
            self.root.bind('<Return>', _enter_build)
            self.root.bind('<KP_Enter>', _enter_build)
        except Exception:
            pass


    def _render_deploy_page(self):
        self._render_title('Deploy', y=40)
        self._render_paragraph('Preparing to deploy. We will verify steps and perform actions as needed.', y=90)
        # Render simple list of steps (static view). Runtime updates can redraw as needed.
        y = 140
        left = 56
        if not hasattr(self, 'deploy_steps'):
            self.deploy_steps = [
                {'name': 'Build Prole macOS app', 'status': 'pending'},
                {'name': 'Build workstation Docker image', 'status': 'pending'},
                {'name': 'Check Docker is running', 'status': 'pending'},
                {'name': 'Install Prole Tools.app', 'status': 'pending'},
            ]
        for step in self.deploy_steps:
            # status circle (pending empty)
            self._canvas_items.append(ui.canvas_oval(self, left, y, left+18, y+18, outline='#b0b0b0'))
            self._canvas_items.append(ui.canvas_text(self, left+26, y-2, step['name'], fill='#1d1d1f', font=('Helvetica', 12)))
            y += 26

    def on_deploy(self):
        if getattr(self, '_deploy_running', False):
            return
        self._deploy_running = True
        try:
            if self.deploy_button:
                self.deploy_button.configure(state='disabled')
        except Exception:
            pass

        def worker():
            err = None
            try:
                self.ensure_prole_env()
                self.reload_env_from_shell()
            except Exception as e:
                err = f"Failed to load environment: {e}"
            try:
                self._ensure_prole_directories()
                if 'Install' in self.prole_cfg_data:
                    self.prole_cfg_data['Install']['STATUS'] = 'Deployed'
                self._save_prole_cfg()
            except Exception as e:
                err = err or f"Failed to prepare Prole directories: {e}"

            if err:
                self.safe_after(lambda: messagebox.showerror("Deploy", err))
            else:
                self.safe_after(self.open_drag_install_window)

            def _finish():
                self._deploy_running = False
                try:
                    if self.deploy_button:
                        self.deploy_button.configure(state='normal')
                except Exception:
                    pass
            self.safe_after(_finish)

        threading.Thread(target=worker, daemon=True).start()

    def on_launch(self):
        app_path = self._get_prole_dist_dir() / 'Prole Tools.app'
        if app_path.exists():
            try:
                subprocess.Popen(['open', str(app_path)])
            except Exception:
                pass
        else:
            try:
                messagebox.showerror("Launch", f"App not found at {app_path}. Please build it first.")
            except Exception:
                pass

    def on_prev(self):
        # Custom prev navigation for dependency pages when filtering
        current_id = self.pages[self.page_index][0]
        # Close Terminal if leaving build summary via Prev
        if current_id == 'build_summary':
            try:
                self.close_build_terminal()
            except Exception:
                pass
        if current_id.startswith('dep_'):
            seq = self._dep_navigation_sequence()
            try:
                i = seq.index(current_id)
            except ValueError:
                i = -1
            if i > 0:
                self.show_page(seq[i - 1])
                return
            else:
                # Go back to summary if there is no previous in sequence
                self.show_page('deps_summary')
                return
        if current_id == 'deps_summary':
            self.show_page('welcome')
            return
        if current_id == 'network_scan':
            # Go back to last relevant dep or deps_summary
            if self.all_dependencies_installed():
                self.show_page('deps_summary')
            else:
                seq = self._dep_navigation_sequence()
                self.show_page(seq[-1] if seq else 'deps_summary')
            return
        if current_id == 'env_setup':
            self.show_page('network_scan')
            return
        if current_id == 'init_password':
            self.show_page('env_setup')
            return
        if current_id == 'init_cluster':
            self.show_page('init_password')
            return
        if current_id == 'init_db_build':
            self.show_page('init_cluster')
            return
        if current_id == 'init_scripts':
            self.show_page('init_db_build')
            return
        if current_id == 'kerberos_config':
            self.show_page('init_scripts')
            return
        if current_id == 'supabase_config':
            if self.kerberos_enabled.get():
                self.show_page('kerberos_config')
            else:
                self.show_page('init_scripts')
            return
        if current_id == 'init_cnpg_deploy':
            if self.supabase_enabled.get():
                self.show_page('supabase_config')
                return
            if self.kerberos_enabled.get():
                self.show_page('kerberos_config')
                return
            self.show_page('init_scripts')
            return
        if current_id == 'create_installer':
            self.show_page('init_cnpg_deploy')
            return
        # Default prev
        if self.page_index > 0:
            self.show_page(self.page_index - 1)
            return

    def on_next(self):
        # Special handling for dynamic labels
        current_id = self.pages[self.page_index][0]
        print(f"[DEBUG] on_next: current_id='{current_id}', page_index={self.page_index}")
        
        if current_id == 'welcome':
            self.show_page('deps_summary')
            return
            
        if current_id == 'deps_summary':
            # Determine where to go from summary
            # Always go to the next dependency or Network Scan
            if self.all_dependencies_installed():
                print("[DEBUG] on_next: all deps installed, going to network_scan")
                self.show_page('network_scan')
                return
            
            # Go to first missing dependency page
            seq = self._dep_navigation_sequence()
            print(f"[DEBUG] on_next: missing deps sequence: {seq}")
            if seq:
                self.show_page(seq[0])
            else:
                print("[DEBUG] on_next: all deps seem OK in sequence, going to network_scan")
                self.show_page('network_scan')
            return
            
        if current_id.startswith('dep_'):
            # Navigate within dependency sequence
            seq = self._dep_navigation_sequence()
            print(f"[DEBUG] on_next: dep sequence: {seq}")
            try:
                i = seq.index(current_id)
            except ValueError:
                i = -1
                
            if i >= 0 and i < len(seq) - 1:
                self.show_page(seq[i + 1])
                return
            else:
                # After last relevant dep page, go back to summary if anything is still missing
                if not self.all_dependencies_installed():
                    print("[DEBUG] on_next: some deps still missing, returning to deps_summary")
                    self.show_page('deps_summary')
                else:
                    print("[DEBUG] on_next: all deps now installed, going to network_scan")
                    self.show_page('network_scan')
                return
        
        if current_id == 'network_scan':
            # Capture network scan info
            try:
                self.prole_cfg_data['Network']['KDC_AUTO_DETECTED'] = self.kerberos_kdc.get()
                self.prole_cfg_data['Network']['KERBEROS_AUTO_ENABLED'] = str(self.kerberos_enabled.get())
                self._save_prole_cfg()
            except Exception:
                pass
            self.show_page('env_setup')
            return
            
        if current_id == 'env_setup':
            # Collect values, validate, write env.sh, then go to Database Creation
            vals = {}
            try:
                for k in ('PROLE_HOME','PROLE_CONF','PROLE_DATA','PROLE_LOGS','PROLE_SERVICE'):
                    vals[k] = self._env_entries[k].get().strip()
                    self.prole_cfg_data['System Environment'][k] = vals[k]
                vals['NAMESPACE'] = (self.db_namespace.get() or '').strip()
            except Exception:
                vals = self._env_defaults()
            # Basic validation: require non-empty PROLE_HOME
            if not vals.get('PROLE_HOME'):
                try:
                    messagebox.showerror('Environment', 'Please specify PROLE_HOME')
                except Exception:
                    pass
                return
            try:
                self._save_env_to_file(vals)
                # Reload our environment so subsequent steps (Build) inherit it
                self._after_env_saved()
            except Exception as e:
                try:
                    messagebox.showwarning('Environment', f'Could not save env.sh: {e}')
                except Exception:
                    pass
                return
            self.show_page('init_password')
            return

        if current_id == 'init_password':
            p1 = self.db_password.get()
            p2 = self.db_password_confirm.get()
            if not p1:
                try:
                    messagebox.showerror('Password', 'Password cannot be empty.')
                except Exception:
                    pass
                return
            if p1 != p2:
                try:
                    messagebox.showerror('Password', 'Passwords do not match.')
                except Exception:
                    pass
                return
            self._run_preparation_overlay()
            return
            
        if current_id == 'init_cluster':
            # Capture cluster info
            self.prole_cfg_data['Initialize Cluster']['ENVIRONMENT'] = self.cluster_env.get()
            self.prole_cfg_data['Optional Features']['SUPABASE_ENABLED'] = str(self.supabase_enabled.get())
            self.prole_cfg_data['Optional Features']['KERBEROS_ENABLED'] = str(self.kerberos_enabled.get())
            self.prole_cfg_data['Optional Features']['AT_REST_ENCRYPTION_ENABLED'] = str(self.at_rest_encryption_enabled.get())
            self._save_prole_cfg()
            # Ensure docker is started, then proceed
            if not self.check_docker_running():
                try:
                    messagebox.showerror('Docker', 'Docker is not running. Please start Docker and try again.')
                except Exception:
                    pass
                return
            self.show_page('init_db_build')
            return
            
        if current_id == 'init_scripts':
            self.prole_cfg_data['Initialization Scripts']['STATUS'] = 'Completed' if getattr(self, '_scripts_success', False) else 'Attempted'
            self._save_prole_cfg()
            if self.kerberos_enabled.get():
                self.show_page('kerberos_config')
            elif self.supabase_enabled.get():
                self.show_page('supabase_config')
            else:
                self.show_page('init_cnpg_deploy')
            return
            
        if current_id == 'kerberos_config':
            # Capture kerberos config
            self.prole_cfg_data['Kerberos Authentication']['ENABLED'] = str(self.kerberos_enabled.get())
            self.prole_cfg_data['Kerberos Authentication']['REALM'] = self.kerberos_realm.get()
            self.prole_cfg_data['Kerberos Authentication']['KDC'] = self.kerberos_kdc.get()
            self.prole_cfg_data['Kerberos Authentication']['SERVER'] = self.kerberos_kdc.get()
            self.prole_cfg_data['Kerberos Authentication']['USER'] = self.kerberos_user.get()
            self.prole_cfg_data['Kerberos Authentication']['PASSWORD'] = self.kerberos_password.get()
            self.prole_cfg_data['Kerberos Authentication']['AD_PORT_FORWARD'] = os.environ.get('KRB5_AD_PORT_FORWARD', '1')
            self.prole_cfg_data['Kerberos Authentication']['AD_TCP_PORTS'] = os.environ.get('KRB5_AD_TCP_PORTS', '88 389 445 464 636')
            self.prole_cfg_data['Kerberos Authentication']['AD_UDP_PORTS'] = os.environ.get('KRB5_AD_UDP_PORTS', '88 464')
            self.prole_cfg_data['Kerberos Authentication']['AD_PROXY_HOST_NETWORK'] = os.environ.get('KRB5_AD_PROXY_HOST_NETWORK', '1')
            self.prole_cfg_data['Kerberos Authentication']['AD_PROXY_IMAGE'] = os.environ.get('KRB5_AD_PROXY_IMAGE', 'alpine/socat')
            self.prole_cfg_data['Kerberos Authentication']['AD_PROXY_SERVICE'] = os.environ.get('KRB5_AD_SERVICE_NAME', 'prole-kerberos-ad-dc')
            self._save_prole_cfg()
            if self.supabase_enabled.get():
                self.show_page('supabase_config')
            else:
                self.show_page('init_cnpg_deploy')
            return

        if current_id == 'supabase_config':
            self.prole_cfg_data['Optional Features']['SUPABASE_ENABLED'] = str(self.supabase_enabled.get())
            self.prole_cfg_data['Supabase'] = {'STATUS': 'Deployed' if getattr(self, '_supabase_success', False) else 'Attempted'}
            self._save_prole_cfg()
            self.show_page('init_cnpg_deploy')
            return
            
        if current_id == 'init_cnpg_deploy':
            self.prole_cfg_data['Prole DB Deploy']['STATUS'] = 'Deployed' if getattr(self, '_cnpg_success', False) else 'Attempted'
            self._save_prole_cfg()
            self.show_page('create_installer')
            return
            
        if current_id == 'create_installer':
            print("[DEBUG] on_next: at create_installer, Finish clicked. Closing.")
            if 'Install' in self.prole_cfg_data:
                self.prole_cfg_data['Install']['STATUS'] = 'Finished'
            self._save_prole_cfg()
            self.root.destroy()
            return

        # Default next
        if self.page_index < len(self.pages) - 1:
            print(f"[DEBUG] on_next: default next to index {self.page_index + 1}")
            self.show_page(self.page_index + 1)
        else:
            print("[DEBUG] on_next: already at last page")
            return

    def update_footer(self):
        # Default states for tk.Button
        self.prev_button.configure(state='normal')
        self.next_button.configure(state='normal')

        first = self.page_index == 0
        # Base label
        self.next_button.configure(text='Next')

        # Page-specific adjustments
        pid = self.pages[self.page_index][0]
        if pid == 'build':
            # Build page: show Build or Next depending on state
            if getattr(self, '_built_success', False):
                self.next_button.configure(text='Next')
            else:
                self.next_button.configure(text='Build')
        elif pid == 'init_scripts':
            # Initialization Scripts: Next is disabled until success
            if getattr(self, '_scripts_success', False):
                self.next_button.configure(state='normal')
            else:
                self.next_button.configure(state='disabled')
        elif pid == 'supabase_config':
            # Supabase screen: Next is disabled until success
            if getattr(self, '_supabase_success', False):
                self.next_button.configure(state='normal')
            else:
                self.next_button.configure(state='disabled')
        # Visibility rules
        self.prev_button.pack_forget()
        self.next_button.pack_forget()
        if self.deploy_button:
            self.deploy_button.pack_forget()
        if self.launch_button:
            self.launch_button.pack_forget()

        if pid == 'create_installer':
            if self.launch_button:
                self.launch_button.pack(side='right', padx=(0, 20), pady=12)
            if self.deploy_button:
                self.deploy_button.pack(side='right', padx=(0, 8), pady=12)
            self.prev_button.pack(side='right', padx=(0, 8), pady=12)
            return

        if first:
            self.next_button.pack(side='right', padx=(0, 20), pady=12)
        else:
            # [Prev] [Next] clustered right
            self.next_button.pack(side='right', padx=(0, 20), pady=12)
            self.prev_button.pack(side='right', padx=(0, 8), pady=12)

    def _splash_should_hide_nav(self) -> bool:
        """Deprecated: Welcome page no longer performs dependency checks or gates navigation."""
        return False

    def _create_page_welcome(self):
        f = self._page_container()
        ttk.Label(f, text='Welcome to Prole', style='Title.TLabel').pack(anchor='w', padx=24, pady=(24, 6))
        msg = (
            'Thanks for joining Prole. We will prepare your system and install the software needed to build and run Prole.'
        )
        ttk.Label(f, text=msg, style='Body.TLabel', wraplength=800, justify='left').pack(anchor='w', padx=24)
        # self._register_page('welcome', f)

    def _create_page_dependencies_summary(self):
        f = self._page_container()
        ttk.Label(f, text='Dependencies', style='Title.TLabel').pack(anchor='w', padx=24, pady=(24, 6))
        self.deps_container = ttk.Frame(f)
        self.deps_container.pack(fill='both', expand=True, padx=16, pady=8)

        self.dep_status = {}
        for dep in self.dependencies:
            row = ttk.Frame(self.deps_container)
            row.pack(fill='x', pady=6)
            indicator = tk.Canvas(row, width=18, height=18, highlightthickness=0)
            indicator.pack(side='left', padx=8)
            name = ttk.Label(row, text=dep['name'], style='Body.TLabel')
            name.pack(side='left')
            info = ttk.Label(row, text='', style='Dim.TLabel')
            info.pack(side='left', padx=10)
            self.dep_status[dep['id']] = {'canvas': indicator, 'info': info, 'dep': dep}
        # Verify all checkbox (controls navigation behavior)
        chk = ttk.Checkbutton(f, text='Verify all dependencies', variable=self.verify_mode, command=self.update_footer)
        chk.pack(anchor='w', padx=24, pady=(4, 0))

        # Message label must be created before refresh to avoid AttributeError
        self.deps_msg = ttk.Label(f, text='', style='Dim.TLabel')
        self.deps_msg.pack(anchor='w', padx=24, pady=(8, 8))
        # Now we can safely populate the UI. Start async scan to avoid startup delay
        self.deps_msg.configure(text='Checking dependencies...')
        self.start_dependency_scan()
        # self._register_page('deps_summary', f)

    def start_dependency_scan(self):
        """Scan dependencies in a background thread to avoid blocking UI startup."""
        if self.validation_running:
            return
        self.validation_running = True

        # Hold incremental results so we can update the status line and icons progressively
        self._dep_scan_results = {}

        def worker():
            for dep in self.dependencies:
                try:
                    ok, location, version = self.get_dep_info(dep)
                except Exception:
                    ok, location, version = False, None, None
                did = dep['id']
                # Save and apply incrementally
                self._dep_scan_results[did] = (ok, location, version)
                self.safe_after(lambda d=did, o=ok, l=location, v=version: self._apply_dependency_incremental(d, o, l, v))
                try:
                    time.sleep(0.02)
                except Exception:
                    pass
            # After all are processed, finalize pass to unify any remaining labels
            self.safe_after(lambda: self._apply_dependency_scan(dict(self._dep_scan_results)))

        t = threading.Thread(target=worker, daemon=True)
        self.validation_thread = t
        t.start()

    def _apply_dependency_incremental(self, dep_id: str, ok: bool, location, version):
        """Update the dependencies page row and message as each check completes."""
        if not hasattr(self, 'dep_status'):
            return
        slot = self.dep_status.get(dep_id)
        if not slot:
            return
        # Update dot icon and info text for this row
        self._draw_status(slot['canvas'], 'success' if ok else 'error')
        if ok:
            norm_ver = self.normalize_version(version) if version else ''
            slot['info'].configure(text=(norm_ver or ''))
        else:
            slot['info'].configure(text='Not installed')

        # Update the message line with current missing list
        if hasattr(self, '_dep_scan_results'):
            missing = [self.dep_status[d]['dep']['name'] for d, res in self._dep_scan_results.items() if not res[0] and d in self.dep_status]
            if hasattr(self, 'deps_msg') and self.deps_msg is not None:
                if missing:
                    self.deps_msg.configure(text=f"Preparing to install ... {', '.join(missing)}")
                else:
                    self.deps_msg.configure(text='All dependencies installed.')
        # Footer may need to react if verify mode is enabled
        self.update_footer()
        
        # Update prole.cfg data
        try:
            status_str = f"installed (version {version})" if ok else "not installed"
            self.prole_cfg_data['Dependencies'][dep_id] = status_str
            self._save_prole_cfg()
        except Exception:
            pass

    def _apply_dependency_scan(self, results: dict):
        """Apply scan results to the summary UI and footer labels."""
        self.validation_running = False
        any_missing = False
        for did, slot in self.dep_status.items():
            ok, location, version = results.get(did, (False, None, None))
            self._draw_status(slot['canvas'], 'success' if ok else 'error')
            if ok:
                norm_ver = self.normalize_version(version) if version else ''
                slot['info'].configure(text=(norm_ver or ''))
            else:
                any_missing = True
                slot['info'].configure(text='Not installed')

        has_msg = hasattr(self, 'deps_msg') and self.deps_msg is not None
        if any_missing:
            missing = [slot['dep']['name'] for did, slot in self.dep_status.items() if not results.get(did, (False, None, None))[0]]
            if missing and has_msg:
                self.deps_msg.configure(text=f"Preparing to install ... {', '.join(missing)}")
        else:
            if has_msg:
                self.deps_msg.configure(text='All dependencies installed.')
        self.update_footer()

    def _create_page_dependency(self, dep):
        f = self._page_container()
        ttk.Label(f, text=dep['name'], style='Title.TLabel').pack(anchor='w', padx=24, pady=(24, 6))
        ttk.Label(f, text=dep['description'], style='Body.TLabel', wraplength=800, justify='left').pack(anchor='w', padx=24)
        status_var = tk.StringVar(value='Checking...')
        loc_var = tk.StringVar(value='')
        ver_var = tk.StringVar(value='')

        info_frame = ttk.Frame(f)
        info_frame.pack(fill='x', padx=24, pady=12)
        # Pretty status row with an icon
        status_row = ttk.Frame(info_frame)
        status_row.pack(anchor='w', fill='x')
        status_icon = tk.Canvas(status_row, width=18, height=18, highlightthickness=0)
        status_icon.pack(side='left', padx=(0, 8), pady=(2, 0))
        ttk.Label(status_row, textvariable=status_var, style='Body.TLabel').pack(side='left')

        # Detail rows (hidden when not installed)
        loc_label = ttk.Label(info_frame, textvariable=loc_var, style='Dim.TLabel')
        ver_label = ttk.Label(info_frame, textvariable=ver_var, style='Dim.TLabel')
        loc_label.pack(anchor='w')
        ver_label.pack(anchor='w')

        link = ttk.Label(f, text='Click to install', foreground='#0a84ff', cursor='hand2', style='Body.TLabel')
        link.pack(anchor='w', padx=24, pady=(12, 0))

        def _draw_status_icon(canvas, status):
            ui.canvas_clear(canvas)
            if status == 'installed':
                ui.canvas_oval_on(canvas, 1, 1, 17, 17, fill='#34c759', outline='')
                ui.canvas_line_on(canvas, 4, 9, 8, 13, fill='white', width=2)
                ui.canvas_line_on(canvas, 8, 13, 15, 5, fill='white', width=2)
            elif status == 'missing':
                # Friendly warning dot with exclamation
                ui.canvas_oval_on(canvas, 1, 1, 17, 17, fill='#ff9f0a', outline='')
                ui.canvas_line_on(canvas, 9, 5, 9, 11, fill='white', width=2)
                ui.canvas_oval_on(canvas, 8, 13, 10, 15, fill='white', outline='white')

        def check_then_update():
            ok, location, version = self.get_dep_info(dep)
            if ok:
                status_var.set('Installed')
                _draw_status_icon(status_icon, 'installed')
                loc_var.set(f'Location: {location or ""}')
                norm_ver = self.normalize_version(version) if version else None
                ver_var.set(f'Version: {norm_ver or ""}')
                # Ensure details visible
                try:
                    loc_label.pack_configure()
                    ver_label.pack_configure()
                    link.pack_forget()
                except Exception:
                    pass
            else:
                status_var.set('Not installed')
                _draw_status_icon(status_icon, 'missing')
                # Hide undefined details instead of showing dashes
                try:
                    loc_label.pack_forget()
                    ver_label.pack_forget()
                except Exception:
                    pass
                try:
                    # Keep install link visible if we have a command
                    if dep.get('install_cmd') and not link.winfo_ismapped():
                        link.pack(anchor='w', padx=24, pady=(12, 0))
                except Exception:
                    pass

        self.root.after(50, check_then_update)

        def do_install(event=None):
            self.open_terminal_with_command(dep.get('install_cmd'))

        if dep.get('install_cmd'):
            link.bind('<Button-1>', do_install)
        else:
            try:
                link.pack_forget()
            except Exception:
                pass

        # self._register_page(f'dep_{dep["id"]}', f)

    def _dep_navigation_sequence(self, force_all: bool = False):
        """Return a list of dependency page ids to traverse next.
        - If force_all is True or verify_mode is True: include all dep pages in defined order.
        - Else: include only missing dependency pages based on current checks.
        """
        if force_all or self.verify_mode.get():
            res = [f'dep_{d["id"]}' for d in self.dependencies]
            print(f"[DEBUG] _dep_navigation_sequence (force_all={force_all}): {res}")
            return res
        seq = []
        for d in self.dependencies:
            ok, _, _ = self.get_dep_info(d)
            if not ok:
                seq.append(f'dep_{d["id"]}')
        print(f"[DEBUG] _dep_navigation_sequence: {seq}")
        return seq

    def _create_page_build(self):
        f = self._page_container()
        ttk.Label(f, text='Build', style='Title.TLabel').pack(anchor='w', padx=24, pady=(24, 6))
        ttk.Label(f, text='Choose a target and build the artifacts.', style='Body.TLabel').pack(anchor='w', padx=24)
        wrap = ttk.Frame(f)
        wrap.pack(anchor='w', padx=24, pady=12)
        ttk.Label(wrap, text='Target Environment:', style='Body.TLabel').pack(side='left')
        self.deploy_environment = tk.StringVar(value='Dev')
        ttk.Combobox(wrap, textvariable=self.deploy_environment, values=['Dev', 'Service', 'Prod'], state='readonly', width=18).pack(side='left', padx=10)

        # Build output console
        # Use a background frame to ensure NO borders are visible around the console
        console_bg = tk.Frame(f, bg='white', highlightthickness=0, bd=0)
        console_bg.pack(fill='both', expand=True, padx=24, pady=12)
        self.build_output_console = ui.TerminalConsole(console_bg, highlightthickness=0, bd=0)
        self.build_output_console.pack(fill='both', expand=True, padx=1, pady=1)
        self.build_output = self.build_output_console.text

        # self._register_page('build', f)

    def _create_page_deploy(self):
        f = self._page_container()
        ttk.Label(f, text='Deploy', style='Title.TLabel').pack(anchor='w', padx=24, pady=(24, 6))
        ttk.Label(f, text='Preparing to deploy. We will verify steps and perform actions as needed.', style='Body.TLabel', wraplength=800).pack(anchor='w', padx=24)

        # Reuse existing deploy steps UI but on light theme
        self.deploy_steps = [
            {'name': 'Build Prole macOS app', 'status': 'pending'},
            {'name': 'Check Docker is running', 'status': 'pending'},
            {'name': 'Check or configure container registry', 'status': 'pending'},
            {'name': 'Ensure target cluster', 'status': 'pending'},
            {'name': 'Build prole-db Docker image', 'status': 'pending'},
            {'name': 'Tag Docker image for registry', 'status': 'pending'},
            {'name': 'Push image to registry', 'status': 'pending'},
            {'name': 'Import image to k3d cluster (Dev only)', 'status': 'pending'},
            {'name': 'Install LaunchAgent for port-forwards (Dev)', 'status': 'pending'},
        ]
        self.deploy_widgets = {}
        container = ttk.Frame(f)
        container.pack(fill='both', expand=True, padx=16, pady=8)
        for step in self.deploy_steps:
            self._create_deploy_row(container, step)

        # self._register_page('deploy', f)

    def _create_deploy_row(self, parent, step):
        row = ttk.Frame(parent)
        row.pack(fill='x', pady=6)
        canvas = tk.Canvas(row, width=20, height=20, highlightthickness=0)
        canvas.pack(side='left', padx=8)
        lbl = ttk.Label(row, text=step['name'], style='Body.TLabel')
        lbl.pack(side='left')
        status = ttk.Label(row, text='Pending', style='Dim.TLabel')
        status.pack(side='right', padx=8)
        self.deploy_widgets[step['name']] = {'canvas': canvas, 'label': status, 'step': step}
        self._draw_status(canvas, 'pending')

    def _draw_status(self, canvas, status):
        ui.canvas_clear(canvas)
        if status == 'success':
            ui.canvas_oval_on(canvas, 2, 2, 18, 18, fill='#34c759', outline='')
            ui.canvas_line_on(canvas, 5, 10, 9, 14, fill='white', width=2)
            ui.canvas_line_on(canvas, 9, 14, 16, 6, fill='white', width=2)
        elif status == 'running':
            ui.canvas_oval_on(canvas, 2, 2, 18, 18, fill='#ffd60a', outline='')
        elif status == 'error':
            ui.canvas_oval_on(canvas, 2, 2, 18, 18, fill='#ff3b30', outline='')
        else:
            ui.canvas_oval_on(canvas, 2, 2, 18, 18, outline='#b0b0b0')

    # --------------- Dependency helpers ---------------
    def refresh_dependencies_ui(self):
        """Deprecated synchronous refresh retained for compatibility.
        Prefer start_dependency_scan -> _apply_dependency_scan.
        """
        self.start_dependency_scan()

    def all_dependencies_installed(self):
        for dep in self.dependencies:
            ok, _, _ = self.get_dep_info(dep)
            if not ok:
                print(f"[DEBUG] all_dependencies_installed: '{dep['id']}' is MISSING")
                return False
        print("[DEBUG] all_dependencies_installed: YES (all OK)")
        return True

    def get_dep_info(self, dep):
        """Delegate dependency probing to installer.config.get_dep_info."""
        return inst_config.get_dep_info(dep)

    def normalize_version(self, text: str) -> str:
        """Normalize versions via installer.config.normalize_version."""
        return inst_config.normalize_version(text)

    def open_terminal_with_command(self, command: str | None):
        if not command:
            return
        try:
            # Always create a brand-new Terminal window and paste via clipboard
            if platform.system() == 'Darwin':
                win_id = self._terminal_create_new_window()
                if win_id:
                    # Position reasonably
                    l, t, r, b = self._compute_terminal_bounds(radio_bottom_y=120)
                    self._terminal_set_bounds_by_id(win_id, l, t, r, b)
                    self._terminal_paste_by_id(win_id, command, press_enter=False)
                    return
            # Fallback: copy to clipboard and open Terminal
            subprocess.run(['bash', '-lc', f'printf %s {shlex.quote(command)} | pbcopy && open -a Terminal'])
        except Exception:
            webbrowser.open_new_tab('https://brew.sh')

    # ---------------- Build integration ----------------
    def perform_build(self):
        """Run Prole build in an embedded console (Scoped bash subprocess)."""
        self._action_flags['build.run_build'] = True
        # Ensure environment exists and is readable before attempting build
        try:
            self.ensure_prole_env()
        except Exception as e:
            # Print a readable error to the console area and abort
            try:
                self._console_press_enter()
            except Exception:
                pass
            err_msg = str(e).replace("'", "'\\''")
            err = f"echo 'ERROR: {err_msg}' && exit 1"
            self._run_in_console(err, None, on_complete=lambda rc: None)
            return
        # Prepare logs dir and file
        try:
            self._build_attempted = True
        except Exception:
            pass
        # reset success flag until proven otherwise
        try:
            self._built_success = False
        except Exception:
            pass
        logs_dir = self._resolve_prole_logs_dir()
        try:
            logs_dir.mkdir(parents=True, exist_ok=True)
        except Exception:
            pass
        ts = time.strftime('%Y%m%d-%H%M%S')
        log_path = logs_dir / f'build-{ts}.log'
        self.last_build_log_path = str(log_path)
        self._record_install_log(log_path)

        # Compose build command
        env = getattr(self, 'deploy_env_value', 'Dev')
        base_cmd = self.get_build_command(env)
        # Hostname safety guard: ensure commands run only on the machine that launched the installer
        guard = ''
        if getattr(self, 'expected_host', None):
            eh = self.expected_host
            guard = f'host=$(hostname -s); if [ "$host" != "{eh}" ]; then echo "ERROR: wrong host $host (expected {eh})"; exit 1; fi; '
        # Simulate pressing Enter on the previewed command; do not echo a duplicate command
        self._console_press_enter()
        # Compose a verbose wrapped build command with environment diagnostics and tracing
        full_cmd = guard + self._compose_verbose_build_command(base_cmd)

        # Run in embedded console
        self._run_in_console(full_cmd, self.last_build_log_path, on_complete=lambda rc: self._on_build_complete(rc))

    def _compose_verbose_build_command(self, base_cmd: str) -> str:
        """Wrap the provided build command with a verbose, diagnostic-rich shell script.

        Adds:
        - Timestamps and section headers
        - Platform/OS/tooling info (uname, macOS version, Xcode/Swift, Java, Maven, Docker, Git)
        - set -euxo pipefail for tracing and early failure
        - Echo of the actual build command
        """
        # Use portable bash; guard external tool probes to avoid hard failures
        prologue = r'''
echo "====[PROLE] Build started $(date '+%Y-%m-%d %H:%M:%S %Z')";
echo "---- System -------------------------------------------------------";
uname -a || true;
printf "ARCH=%s\n" "$(uname -m)" || true;
if command -v sw_vers >/dev/null 2>&1; then sw_vers || true; fi;
echo "---- Tooling ------------------------------------------------------";
if command -v xcodebuild >/dev/null 2>&1; then xcodebuild -version || true; else echo "xcodebuild: not found"; fi;
if command -v swift >/dev/null 2>&1; then swift --version || true; else echo "swift: not found"; fi;
if command -v java >/dev/null 2>&1; then java -version 2>&1 | sed 's/^/java: /'; else echo "java: not found"; fi;
if command -v mvn >/dev/null 2>&1; then mvn -v || true; else echo "mvn: not found"; fi;
if command -v docker >/dev/null 2>&1; then docker version || true; else echo "docker: not found"; fi;
echo "---- Git ----------------------------------------------------------";
if command -v git >/dev/null 2>&1; then \
  (git -C "$(pwd)" rev-parse --is-inside-work-tree >/dev/null 2>&1 && \
   echo "repo: $(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)")" && \
   echo "branch: $(git rev-parse --abbrev-ref HEAD 2>/dev/null)" && \
   echo "commit: $(git rev-parse --short HEAD 2>/dev/null)" && \
   git status --porcelain=v1 | sed 's/^/  /' || true) || echo "not a git repo"; \
else echo "git: not found"; fi;
echo "-------------------------------------------------------------------";
'''

        # The actual build with tracing and timing
        wrapped = f"""
( 
  set -euxo pipefail
  {prologue}
  echo "====[PROLE] Executing build command:";
  printf '%s\n' {shlex.quote(base_cmd)};
  echo "-------------------------------------------------------------------";
  start_ts=$(date +%s || echo 0);
  {base_cmd}
  rc=$?
  end_ts=$(date +%s || echo 0);
  dur=$((end_ts - start_ts));
  echo "-------------------------------------------------------------------";
  if [ $rc -eq 0 ]; then
    echo "====[PROLE] Build finished OK in ${{dur}}s at $(date '+%Y-%m-%d %H:%M:%S %Z')";
  else
    echo "====[PROLE] Build FAILED (rc=$rc) in ${{dur}}s at $(date '+%Y-%m-%d %H:%M:%S %Z')";
  fi
  exit $rc
)
"""
        return wrapped

    def _on_build_complete(self, returncode: int):
        # After build completes, update state and check for removable disks
        try:
            self._built_success = (returncode == 0)
        except Exception:
            self._built_success = False
        # Re-enable Next button
        try:
            self.next_button.configure(state='normal')
        except Exception:
            pass
        # Navigate to disk_selection if removable disks exist, otherwise build_summary
        if getattr(self, '_built_success', False):
            disks = self.get_removable_disks()
            if disks:
                self.show_page('disk_selection')
            else:
                self.show_page('build_summary')
        else:
            # Build failed, stay on build page
            pass

    # ---------------- Embedded console helpers ----------------
    def _ensure_console_overlay(self, radio_bottom_y: int = 160):
        """Create semi-transparent backdrop and a ScrolledText console overlay.
        The overlay is placed within slide_area between given top and bottom margins.
        """
        # Ensure slide_area is visible
        self.slide_area.place(relx=0, rely=0, relwidth=1, relheight=1)
        self.slide_area.lift()

        # Compute geometry within slide area
        geom = self._compute_console_geometry(radio_bottom_y)
        left, top, width, height = geom
        
        # Use a background frame to ensure NO borders are visible around the console
        console_bg = tk.Frame(self.slide_area, bg='white', highlightthickness=0, bd=0)
        console_bg.place(x=left, y=top, width=width, height=height)
        
        # Create TerminalConsole overlay
        console = ui.TerminalConsole(console_bg, highlightthickness=0, bd=0)
        console.pack(fill='both', expand=True, padx=1, pady=1)
        self._overlay_widgets.append(console_bg)
        self._overlay_widgets.append(console)
        self._console_text = console.text
        
        # Keep overlay positioned on resize
        def _on_resize(_evt=None):
            l, t, w, h = self._compute_console_geometry(radio_bottom_y)
            try:
                console_bg.place(x=l, y=t, width=w, height=h)
            except Exception:
                pass
        # Bind to slide area; store bind id to unbind later
        self._overlay_bind_id = self.slide_area.bind('<Configure>', _on_resize)

    def _compute_console_geometry(self, radio_bottom_y: int) -> tuple[int, int, int, int]:
        """Return (left, top, width, height) for the console overlay area."""
        try:
            w = self.slide_area.winfo_width()
            h = self.slide_area.winfo_height()
        except Exception:
            w, h = 1300 * 0.75, 910 - 64 # Content area size approx
        margin = 24
        top = max(radio_bottom_y + 10, 120)
        bottom = max(top + 180, h - 16)  # ensure some height
        height = max(160, bottom - top - 80) if bottom - top > 260 else max(140, h - top - 24)
        # Recompute bottom based on height
        bottom = min(h - 24, top + height)
        left = margin
        width = max(300, w - 2 * margin)
        return (left, top, width, bottom - top)

    def _append_console(self, text: str):
        txt = getattr(self, '_console_text', None)
        if not txt:
            return
        try:
            if not txt.winfo_exists():
                return
            txt.configure(state='normal')
            txt.insert('end', text)
            txt.see('end')
            txt.configure(state='disabled')
        except Exception:
            pass

    def _console_press_enter(self):
        """Simulate pressing Enter on the console preview line: remove blinking cursor if present and add a newline."""
        txt = getattr(self, '_console_text', None)
        if not txt:
            return
        # Stop cursor blinking
        if getattr(self, '_cursor_blink_after_id', None):
            try:
                self.root.after_cancel(self._cursor_blink_after_id)
            except Exception:
                pass
            self._cursor_blink_after_id = None
            self._cursor_blink_visible = False
        try:
            txt.configure(state='normal')
            # If last char is our fake cursor, remove it
            try:
                last_char = txt.get('end-2c', 'end-1c')
                if last_char in ('_', '|'):
                    txt.delete('end-2c', 'end-1c')
            except Exception:
                pass
            txt.insert('end', '\n')
            txt.see('end')
            txt.configure(state='disabled')
        except Exception:
            pass

    # ----- Command preview & blinking cursor helpers -----
    def _get_user_host(self) -> tuple[str, str]:
        try:
            user = os.environ.get('USER') or os.getlogin()
        except Exception:
            user = 'user'
        host = getattr(self, 'expected_host', None) or (platform.node() or 'host').split('.')[0]
        return user, host

    def _compose_build_preview(self) -> str:
        env = getattr(self, 'deploy_env_value', 'Dev')
        cmd = self.get_build_command(env)
        user, host = self._get_user_host()
        return f"[{user}@{host}]# {cmd}"

    def _console_set_preview(self, line: str):
        """Clear console and show a single-line preview with blinking cursor."""
        txt = getattr(self, '_console_text', None)
        if not txt:
            return
        # Stop any previous blinking first
        if getattr(self, '_cursor_blink_after_id', None):
            try:
                self.root.after_cancel(self._cursor_blink_after_id)
            except Exception:
                pass
            self._cursor_blink_after_id = None
        self._cursor_blink_visible = False
        try:
            txt.configure(state='normal')
            txt.delete('1.0', 'end')
            txt.insert('end', line)
            txt.see('end')
            txt.configure(state='disabled')
        except Exception:
            return

        # Start blinking cursor at end of line
        def blink():
            t = getattr(self, '_console_text', None)
            if t is None:
                self._cursor_blink_after_id = None
                return
            try:
                t.configure(state='normal')
                # Remove existing cursor
                if self._cursor_blink_visible:
                    # Delete last character if it's our cursor
                    end_index = t.index('end-1c')
                    if end_index and end_index != '1.0':
                        last_char = t.get('end-2c', 'end-1c')
                        if last_char in ('_', '|'):
                            t.delete('end-2c', 'end-1c')
                    self._cursor_blink_visible = False
                else:
                    # Append cursor
                    t.insert('end', '_')
                    self._cursor_blink_visible = True
                t.see('end')
                t.configure(state='disabled')
            except Exception:
                self._cursor_blink_after_id = None
                return
            # schedule next toggle
            self._cursor_blink_after_id = self.root.after(600, blink)

        self._cursor_blink_after_id = self.root.after(600, blink)

    def _run_in_console(self, command: str, log_path: str, on_complete=None):
        """Run a bash -lc command in a background subprocess and stream output to the console and a log file.
        This function does not echo the command into the console so that the UI behaves like pressing Enter
        on the previously previewed command line.
        """
        # Ensure console exists
        if not getattr(self, '_console_text', None):
            self._ensure_console_overlay(160)
        # Stop cursor blinking before starting execution
        if getattr(self, '_cursor_blink_after_id', None):
            try:
                self.root.after_cancel(self._cursor_blink_after_id)
            except Exception:
                pass
            self._cursor_blink_after_id = None
            self._cursor_blink_visible = False
        # Terminate any previous process
        if getattr(self, '_running_process', None):
            self._terminate_running_process()
        # Open log file
        try:
            self._console_log_fp = open(log_path, 'a', buffering=1, encoding='utf-8')
        except Exception:
            self._console_log_fp = None
        # Start process group for safe termination
        def preexec():
            try:
                os.setsid()
            except Exception:
                pass
        try:
            proc = subprocess.Popen(['bash', '-lc', command], stdout=subprocess.PIPE, stderr=subprocess.STDOUT,
                                    text=True, bufsize=1, preexec_fn=preexec)
            self._running_process = proc
        except Exception as e:
            self._append_console(f"Failed to start process: {e}\n")
            if self._console_log_fp:
                try:
                    self._console_log_fp.write(f"Failed to start process: {e}\n")
                except Exception:
                    pass
            self._running_process = None
            return
        # Disable Next while running
        try:
            self.next_button.configure(text='Building…', state='disabled')
        except Exception:
            pass
        # Reader thread
        def reader():
            rc = None
            try:
                for line in proc.stdout:
                    if line is None:
                        break
                    self.safe_after(lambda s=line: self._append_console(s))
                    if self._console_log_fp:
                        try:
                            self._console_log_fp.write(line)
                        except Exception:
                            pass
                rc = proc.wait()
            except Exception:
                pass
            finally:
                if self._console_log_fp:
                    try:
                        self._console_log_fp.flush()
                        self._console_log_fp.close()
                    except Exception:
                        pass
                    self._console_log_fp = None
                self._running_process = None
                if on_complete:
                    self.safe_after(lambda: on_complete(rc if rc is not None else -1))
        t = threading.Thread(target=reader, daemon=True)
        t.start()

    def _terminate_running_process(self):
        proc = getattr(self, '_running_process', None)
        if not proc:
            return
        try:
            pgid = os.getpgid(proc.pid)
            os.killpg(pgid, signal.SIGTERM)
        except Exception:
            try:
                proc.terminate()
            except Exception:
                pass
        # best-effort kill after short delay
        try:
            for _ in range(10):
                if proc.poll() is not None:
                    break
                time.sleep(0.05)
            if proc.poll() is None:
                try:
                    pgid = os.getpgid(proc.pid)
                    os.killpg(pgid, signal.SIGKILL)
                except Exception:
                    proc.kill()
        except Exception:
            pass
        self._running_process = None

    # ---------------- Build helpers (Terminal window management) ----------------
    def _terminal_create_new_window(self) -> str | None:
        """Create a brand-new Terminal window (never reuse existing) and return its id."""
        if platform.system() != 'Darwin':
            return None
        osa = '''
        tell application "Terminal" to activate
        delay 0.05
        tell application "System Events"
            if exists process "Terminal" then
                tell process "Terminal"
                    set frontmost to true
                    try
                        click menu item "New Window" of menu "Shell" of menu bar 1
                    on error
                        keystroke "n" using {command down}
                    end try
                end tell
            end if
        end tell
        delay 0.1
        tell application "Terminal"
            try
                set _w to front window
                set _id to id of _w
                do script "" in _w
                return _id
            on error
                return ""
            end try
        end tell
        '''
        try:
            result = subprocess.run(['osascript', '-e', osa], capture_output=True, text=True)
            if result.returncode == 0:
                sid = result.stdout.strip()
                return sid or None
        except Exception:
            pass
        return None

    def _terminal_set_bounds_by_id(self, win_id: str, l: int, t: int, r: int, b: int):
        if platform.system() != 'Darwin' or not win_id:
            return
        osa = f'''tell application "Terminal" to try
        set the bounds of every window whose id is {win_id} to {{{l}, {t}, {r}, {b}}}
        end try'''
        try:
            subprocess.run(['osascript', '-e', osa])
        except Exception:
            pass

    def _terminal_paste_by_id(self, win_id: str, text: str, press_enter: bool = False):
        if platform.system() != 'Darwin' or not win_id:
            return
        # Put text on clipboard and paste into our specific window
        try:
            subprocess.run(['bash', '-lc', f'printf %s {shlex.quote(text)} | pbcopy'])
        except Exception:
            pass
        osa = '''
        tell application "Terminal"
            try
                set _wins to every window whose id is {win_id}
                if (count of _wins) > 0 then set front window to item 1 of _wins
            end try
            activate
        end tell
        delay 0.05
        tell application "System Events"
            keystroke "v" using {command down}
        end tell
        '''
        if press_enter:
            osa += '\n' + 'tell application "System Events" to key code 36'
        try:
            subprocess.run(['osascript', '-e', osa])
        except Exception:
            pass
    def _compute_terminal_bounds(self, radio_bottom_y: int = 160) -> tuple[int, int, int, int]:
        """Compute terminal window bounds (left, top, right, bottom) to fit inside
        the installer window between the radio buttons and the footer."""
        try:
            # Window absolute position
            x0 = self.root.winfo_rootx()
            y0 = self.root.winfo_rooty()
            w = self.root.winfo_width()
            h = self.root.winfo_height()
        except Exception:
            # Reasonable defaults
            x0, y0, w, h = 200, 200, 1300, 910
        margin = 24
        top = y0 + radio_bottom_y + 10
        bottom = y0 + h - 90  # leave space for footer
        # Offset left by sidebar width (325) + divider (1)
        left = x0 + 326 + margin
        right = x0 + w - margin
        # Ensure minimum height
        if bottom - top < 160:
            bottom = top + 160
        return (left, top, right, bottom)

    def open_build_terminal_for_canvas_area(self, radio_bottom_y: int = 160):
        """Open a brand-new Terminal.app window and size it to nestle inside the installer."""
        if platform.system() != 'Darwin':
            return
        l, t, r, b = self._compute_terminal_bounds(radio_bottom_y)
        win_id = self._terminal_create_new_window()
        if win_id:
            self._terminal_set_bounds_by_id(win_id, l, t, r, b)
        self.build_terminal_window_id = win_id

    def _start_terminal_follow(self, radio_bottom_y: int = 160):
        """Bind window Configure to keep Terminal bounds anchored to installer area."""
        if platform.system() != 'Darwin':
            return
        self._terminal_follow_rby = radio_bottom_y
        if getattr(self, '_terminal_follow_bound', False):
            return

        def _follow(_evt=None):
            # Debounce slightly
            if getattr(self, '_terminal_follow_after', None):
                try:
                    self.root.after_cancel(self._terminal_follow_after)
                except Exception:
                    pass
            def _do():
                if not getattr(self, 'build_terminal_window_id', None):
                    return
                l, t, r, b = self._compute_terminal_bounds(self._terminal_follow_rby)
                self._terminal_set_bounds_by_id(self.build_terminal_window_id, l, t, r, b)
            self._terminal_follow_after = self.root.after(60, _do)

        self.root.bind('<Configure>', _follow)
        self._terminal_follow_bound = True

    def _stop_terminal_follow(self):
        if getattr(self, '_terminal_follow_bound', False):
            try:
                self.root.unbind('<Configure>')
            except Exception:
                pass
            self._terminal_follow_bound = False

    def paste_into_terminal(self, text: str, press_enter: bool = False):
        """Paste text into Terminal by targeting the build window id if available."""
        if platform.system() != 'Darwin':
            return
        win_id = getattr(self, 'build_terminal_window_id', None)
        if win_id:
            self._terminal_paste_by_id(win_id, text, press_enter=press_enter)
            return
        # Fallback to generic new window
        win_id = self._terminal_create_new_window()
        if win_id:
            self._terminal_paste_by_id(win_id, text, press_enter=press_enter)

    def close_build_terminal(self):
        if platform.system() != 'Darwin':
            return
        # stop following window
        self._stop_terminal_follow()
        win_id = getattr(self, 'build_terminal_window_id', None)
        if not win_id:
            # attempt to close front window politely
            osa = 'tell application "Terminal" to if (count of windows) > 0 then close front window'
        else:
            osa = f'tell application "Terminal" to try\nclose (every window whose id is {win_id})\nend try'
        try:
            subprocess.run(['osascript', '-e', osa])
        except Exception:
            pass

    def get_build_command(self, env: str) -> str:
        """Delegate to installer.build.get_build_command."""
        return inst_get_build_command(PROJECT_ROOT, env)

    # ---------------- Build Summary page ----------------
    def _collect_install_logs(self) -> list[Path]:
        logs_dir = self._resolve_prole_logs_dir()
        build_logs = []
        init_logs = []
        seen = set()

        def _add(p: Path):
            sp = str(p)
            if sp in seen:
                return
            if not p.exists():
                return
            seen.add(sp)
            if p.name.startswith('build-'):
                build_logs.append(p)
            elif p.name.startswith('init_') or p.name.startswith('init-') or p.name == 'init_garage_store.log':
                init_logs.append(p)

        for raw in getattr(self, '_install_run_log_paths', []):
            try:
                _add(Path(raw))
            except Exception:
                pass

        try:
            lbp = getattr(self, 'last_build_log_path', None)
            if lbp:
                _add(Path(lbp))
        except Exception:
            pass

        if not build_logs:
            try:
                candidates = sorted(logs_dir.glob('build-*.log'), key=lambda p: p.stat().st_mtime)
                if candidates:
                    _add(candidates[-1])
            except Exception:
                pass

        if not init_logs:
            try:
                candidates = sorted(logs_dir.glob('init_*.log'))
                for p in candidates:
                    _add(p)
            except Exception:
                pass

        try:
            build_logs.sort(key=lambda p: p.stat().st_mtime)
        except Exception:
            pass
        try:
            init_logs.sort(key=lambda p: p.name)
        except Exception:
            pass
        return build_logs + init_logs

    def _render_create_installer_page(self):
        self.slide_area.lower()

        content_width = self.bg_canvas.winfo_width() or 975
        right_margin = content_width - 48

        ui.canvas_text(self, right_margin, 40, 'Prole', fill='#6e6e73', font=('SF Pro Text', 32, 'bold'), anchor='ne')
        ui.canvas_text(self, right_margin, 85, "Infrastructure Automated.", fill='#6e6e73',
                      font=('SF Pro Text', 18), anchor='ne')

        self._render_title('Install', y=150)

        build_status = "complete" if getattr(self, '_built_success', False) else ("attempted" if getattr(self, '_build_attempted', False) else "not run")
        scripts_status = "complete" if getattr(self, '_scripts_success', False) else ("attempted" if hasattr(self, '_scripts_success') else "not run")
        deploy_status = "deployed" if getattr(self, '_cnpg_success', False) else ("attempted" if hasattr(self, '_cnpg_success') else "not run")

        prole_home = self._resolve_env_value('PROLE_HOME', str(Path.home() / '.prole'))
        prole_conf = str(self._resolve_prole_conf_dir())
        prole_logs = str(self._resolve_prole_logs_dir())

        summary = (
            "Install summary:\n"
            f"• Build status: {build_status}\n"
            f"• Initialization scripts: {scripts_status}\n"
            f"• Prole DB deploy: {deploy_status}\n\n"
            f"PROLE_HOME: {prole_home}\n"
            f"PROLE_CONF: {prole_conf}\n"
            f"PROLE_LOGS: {prole_logs}"
        )
        ui.canvas_text(self, 48, 220, summary, fill='black', font=('SF Pro Text', 13), width=820, anchor='nw')

        ui.canvas_text(self, 48, 340, "Install Artifacts", fill='#1d1d1f', font=('SF Pro Text', 12, 'bold'))

        try:
            self.ensure_prole_env()
            self.reload_env_from_shell()
        except Exception:
            pass
        try:
            self._ensure_prole_directories()
            self._save_prole_cfg()
        except Exception:
            pass

        notebook_bg = tk.Frame(self.bg_canvas, bg='white', highlightthickness=0, bd=0)
        self.install_tabs = ttk.Notebook(notebook_bg, style='TNotebook')
        self.install_tabs.pack(fill='both', expand=True, padx=1, pady=1)

        tab_window = self.bg_canvas.create_window(48, 370, window=notebook_bg, anchor='nw', width=900, height=430)
        self._canvas_items.append(tab_window)
        self._overlay_widgets.append(notebook_bg)
        self._overlay_widgets.append(self.install_tabs)

        def _add_tab(title: str, content: str) -> int:
            console_bg = tk.Frame(self.install_tabs, bg='white', highlightthickness=0, bd=0)
            self.install_tabs.add(console_bg, text=title)
            console = ui.TerminalConsole(console_bg, highlightthickness=0, bd=0)
            console.pack(fill='both', expand=True, padx=1, pady=1)
            console.write(content)
            return console_bg

        logs = self._collect_install_logs()
        for p in logs:
            try:
                text = p.read_text(encoding='utf-8', errors='ignore')
                content = f"{p}\n\n{text}"
            except Exception as e:
                content = f"{p}\n\nFailed to read log: {e}\n"
            _add_tab(p.name, content)

        cfg_path = self._resolve_prole_conf_dir() / 'prole.cfg'
        try:
            cfg_text = cfg_path.read_text(encoding='utf-8', errors='ignore')
            cfg_content = f"{cfg_path}\n\n{cfg_text}"
        except Exception as e:
            cfg_content = f"{cfg_path}\n\nprole.cfg not found or unreadable: {e}\n"
        cfg_tab = _add_tab('prole.cfg', cfg_content)
        try:
            self.install_tabs.select(cfg_tab)
        except Exception:
            pass

    def _render_build_summary_page(self):
        # Ensure slide_area is visible for the build log console
        self.slide_area.place(relx=0, rely=0, relwidth=1, relheight=1)
        self.slide_area.lift()

        # Build Summary: show combined stdout/stderr from last build log
        self._render_title('Build Summary', y=40)
        if getattr(self, '_built_success', False):
            self._render_paragraph('✅ Build completed successfully. You can now drag Prole Tools.app into Applications. Output below:', y=88)
        else:
            # Troubleshooting header
            tips = (
                "❌ Build failed. Troubleshooting tips:\n"
                "• Ensure Xcode Command Line Tools are installed: xcode-select --install\n"
                "• Verify Swift toolchain and SPM networking (try again; network hiccups can happen)\n"
                "• If on Apple Silicon, ensure dependencies target arm64 or install via Homebrew\n"
                "• Clean derived data / SPM cache if needed: rm -rf ~/Library/Developer/Xcode/DerivedData\n"
                "• Check Docker status if Docker-related steps are used\n"
                "• Check the logs below for specific errors"
            )
            self._render_paragraph(tips, y=88)
        logp = getattr(self, 'last_build_log_path', None)
        # Place a scrollable console to show the log
        try:
            # Standardized Console Output area for build summary
            self.build_summary_console = self._create_console_output(y=160, title="Build Log Output", width=900, height=520)
            txt = self.build_summary_console.text
            
            if logp and os.path.exists(logp):
                try:
                    with open(logp, 'r', encoding='utf-8', errors='ignore') as fp:
                        content = fp.read()
                    self.build_summary_console.write(content)
                except Exception as e:
                    self.build_summary_console.write(f"Failed to read log: {e}\n")
            else:
                self.build_summary_console.write('No build log available.')
            
            # Keep standard y for links
            y_links = 760
        except Exception:
            # Fallback: just show path
            self._render_paragraph('No build log could be displayed.', y=120)
            y_links = 140
        
        # Add link to open the log file in Finder/TextEdit
        if logp:
            link = ui.render_link(self, 56, y_links, 'Open build log file')
            self._canvas_items.append(link)

            def _open_log(event):
                ex, ey = event.x, event.y
                bbox = self.bg_canvas.bbox(link)
                if bbox and bbox[0] <= ex <= bbox[2] and bbox[1] <= ey <= bbox[3]:
                    try:
                        if platform.system() == 'Darwin':
                            subprocess.run(['open', logp])
                        else:
                            webbrowser.open(f'file://{logp}')
                    except Exception:
                        pass
            self.bg_canvas.bind('<Button-1>', _open_log)

        # On success, also offer DMG packaging and opening options
        if getattr(self, '_built_success', False):
            try:
                dist_dir = str(self._get_prole_dist_dir())
            except Exception:
                dist_dir = None
            if dist_dir:
                y_links += 30
                # Create DMG
                link2 = ui.render_link(self, 56, y_links, 'Create Prole Tools.dmg')
                self._canvas_items.append(link2)

                def _open_dist(event):
                    ex, ey = event.x, event.y
                    bbox = self.bg_canvas.bbox(link2)
                    if bbox and bbox[0] <= ex <= bbox[2] and bbox[1] <= ey <= bbox[3]:
                        try:
                            # Build the DMG, then offer to open it
                            self.create_dmg()
                            self.open_dmg()
                        except Exception:
                            pass
                self.bg_canvas.bind('<Button-1>', _open_dist)

                # Also link to open dist folder (fallback)
                y_links += 30
                link3 = ui.render_link(self, 56, y_links, 'Open dist folder')
                self._canvas_items.append(link3)

                def _open_dist_folder(event):
                    ex, ey = event.x, event.y
                    bbox = self.bg_canvas.bbox(link3)
                    if bbox and bbox[0] <= ex <= bbox[2] and bbox[1] <= ey <= bbox[3]:
                        try:
                            if platform.system() == 'Darwin':
                                subprocess.run(['open', dist_dir])
                            else:
                                webbrowser.open(f'file://{dist_dir}')
                        except Exception:
                            pass
                self.bg_canvas.bind('<Button-1>', _open_dist_folder)

    # ---------------- Drag-and-drop install (macOS Finder) ----------------
    def _get_prole_dist_dir(self) -> Path:
        return PROJECT_ROOT / 'prole-tools-app' / 'dist'

    def ensure_applications_symlink(self):
        """Deprecated: no longer create /Applications symlink inside the repo.

        We now place the symlink only inside the DMG staging directory to avoid
        confusing IDE indexers and to keep the workspace clean.
        """
        return

    def open_drag_install_window(self):
        """Open the Prole DMG in Finder (macOS) for drag-and-drop install."""
        if platform.system() != 'Darwin':
            return
        p = self._get_dmg_paths()
        dmg = p['final_dmg']
        if not dmg.exists():
            try:
                self.create_dmg()
            except Exception:
                pass
        try:
            subprocess.run(['open', str(dmg)])
        except Exception:
            try:
                subprocess.run(['open', str(p['dist'])])
            except Exception:
                pass

    # ---------------- DMG Packaging ----------------
    def _get_dmg_paths(self):
        # Ensure we have a valid path for DMG output. 
        # Default to ~/Downloads if selected path is home or invalid.
        raw_path = self.selected_local_path.get()
        user_dist = Path(raw_path).expanduser()
        
        if str(user_dist) == str(Path.home()):
            user_dist = Path.home() / 'Downloads'
            self.selected_local_path.set(str(user_dist))

        try:
            user_dist.mkdir(parents=True, exist_ok=True)
        except Exception:
            user_dist = self._get_prole_dist_dir()

        dmg_name = 'Prole Tools.dmg'
        tmp_dmg = user_dist / 'Prole Tools.tmp.dmg'
        final_dmg = user_dist / dmg_name
        
        # Use a temporary staging area in the app's dist dir to keep user folder clean
        app_dist = self._get_prole_dist_dir()
        staging = app_dist / 'dmg_stage'
        bg_dir = staging / '.background'
        bg_img = get_resource_path('img/proleLogoBlueprint.png')
        return {
            'dist': user_dist,
            'tmp_dmg': tmp_dmg,
            'final_dmg': final_dmg,
            'staging': staging,
            'bg_dir': bg_dir,
            'bg_img': bg_img,
        }

    def create_dmg(self):
        """Create a DMG containing Prole Tools.app, a 'setup' binary, and an /Applications symlink."""
        if platform.system() != 'Darwin':
            return
        
        p = self._get_dmg_paths()
        app_src = get_resource_path('prole-app/dist/Prole Tools.app')
        if not app_src.exists():
            print(f"Error: {app_src} not found. Run build first.")
            return

        staging = p['staging']
        try:
            if staging.exists():
                print(f"Cleaning staging area: {staging}")
                shutil.rmtree(staging, ignore_errors=True)
            staging.mkdir(parents=True, exist_ok=True)
            
            # 1. Build static installer binary using PyInstaller
            print("Building static installer binary...")
            installer_name = "Install Prole Infrastructure"
            icon_path = PROJECT_ROOT / 'img' / 'proleIconblueprint.png'
            try:
                # Use --onefile for a single executable
                cmd = [
                    sys.executable, '-m', 'PyInstaller',
                    '--onefile',
                    '--name', installer_name,
                    '--clean',
                    '--noconsole',  # It's a GUI app (tkinter)
                ]
                if icon_path.exists():
                    cmd.extend(['--icon', str(icon_path)])
                
                cmd.append('install.py')
                
                subprocess.check_call(cmd)
                setup_bin = PROJECT_ROOT / 'dist' / installer_name
                if setup_bin.exists():
                    dst_setup = staging / installer_name
                    if dst_setup.exists():
                        if dst_setup.is_dir():
                            shutil.rmtree(dst_setup)
                        else:
                            dst_setup.unlink()
                    shutil.copy2(setup_bin, dst_setup)
                else:
                    print(f"Error: PyInstaller failed to create '{installer_name}' binary.")
            except Exception as e:
                messagebox.showerror("Error", f"Failed to create DMG: {e}")
                print(f"Warning: Failed to build setup binary with PyInstaller: {e}")

            # 2. Copy Prole Tools.app to staging (at root for drag-and-drop)
            print("Copying Prole Tools.app to staging...")
            dst_app = staging / 'Prole Tools.app'
            if dst_app.exists():
                shutil.rmtree(dst_app)
            
            if sys.version_info >= (3, 8):
                shutil.copytree(app_src, dst_app, dirs_exist_ok=True)
            else:
                subprocess.check_call(['cp', '-R', str(app_src), str(dst_app)])
            
            # Inject launcher wrapper into Prole Tools.app
            macos_dir = dst_app / 'Contents' / 'MacOS'
            launcher_path = macos_dir / 'Prole Tools'
            real_bin_path = macos_dir / 'ProleTools.bin'
            if launcher_path.exists() and launcher_path.is_file():
                if real_bin_path.exists():
                    if real_bin_path.is_dir():
                        shutil.rmtree(real_bin_path)
                    else:
                        real_bin_path.unlink()
                os.rename(launcher_path, real_bin_path)
            
            script = """#!/bin/bash
set -euo pipefail
export PROLE_HOME="${PROLE_HOME:-$HOME/.prole}"
if [ -f "$PROLE_HOME/env.sh" ]; then
  . "$PROLE_HOME/env.sh"
fi
DIR="$(cd "$(dirname "$0")" && pwd)"
exec "$DIR/ProleTools.bin" "$@"
"""
            with open(launcher_path, 'w') as fp:
                fp.write(script)
            os.chmod(launcher_path, 0o755)

            # 3. Create Applications symlink
            try:
                os.symlink('/Applications', str(staging / 'Applications'))
            except FileExistsError:
                pass

            # 4. Background image
            if p['bg_dir'].exists():
                shutil.rmtree(p['bg_dir'])
            p['bg_dir'].mkdir(parents=True, exist_ok=True)
            if p['bg_img'].exists():
                shutil.copy2(p['bg_img'], p['bg_dir'] / 'background.png')

            # 5. Create the DMG
            tmp_dmg = p['tmp_dmg']
            final_dmg = p['final_dmg']
            if final_dmg.exists():
                os.remove(final_dmg)

            # Create the DMG using hdiutil
            messagebox.showinfo("Creating DMG", "Building DMG image. This may take a minute...")
            subprocess.check_call([
                'hdiutil', 'create',
                '-volname', 'Prole',
                '-srcfolder', str(staging),
                '-ov', '-format', 'UDRW',  # Create as Read/Write initially to modify view options
                str(tmp_dmg)
            ])
            
            # Positions in DMG:
            # [Install Prole Infrastructure] (left)
            # [Prole Tools.app] (center/right)
            # [Applications] (below Prole Tools.app)
            
            # Note: We use the installer name in the AppleScript. 
            # Finder items need to match the actual file names on disk.
            # \n in filename might be literal or interpreted.
            
            # 6. Set DMG view options (large icons) using AppleScript
            print("Configuring DMG view options...")
            mount_point = Path('/Volumes/Prole')
            try:
                # Detach if already mounted
                subprocess.run(['hdiutil', 'detach', str(mount_point)], capture_output=True)
                
                # Mount the temporary DMG
                subprocess.check_call(['hdiutil', 'attach', str(tmp_dmg), '-nobrowse'])
                
                # Give it a moment to mount
                time.sleep(2)
                
                if mount_point.exists():
                    # Escape the installer name for AppleScript
                    # Use the name that actually exists on disk. 
                    # PyInstaller might have replaced \n with something else in the filename if it was problematic, 
                    # but usually it's literal in the FS if allowed.
                    
                    applescript = f'''
                    tell application "Finder"
                        tell disk "Prole"
                            open
                            set current view of container window to icon view
                            set toolbar visible of container window to false
                            set statusbar visible of container window to false
                            set the_container to container window
                            set bounds of the_container to {{400, 100, 1000, 600}}
                            set icon_view_options to icon view options of the_container
                            set icon size of icon_view_options to 192
                            set arrangement of icon_view_options to not arranged
                            set background picture of icon_view_options to file ".background:background.png"
                            
                            -- Position icons
                            set position of item "{installer_name}" of container window to {{150, 200}}
                            set position of item "Prole Tools.app" of container window to {{450, 200}}
                            set position of item "Applications" of container window to {{450, 400}}
                            
                            update without registering applications
                            delay 2
                            close
                        end tell
                    end tell
                    '''
                    subprocess.run(['osascript', '-e', applescript])
                
                # Detach
                subprocess.check_call(['hdiutil', 'detach', str(mount_point)])
                
                # Convert to final compressed format
                if final_dmg.exists():
                    os.remove(final_dmg)
                subprocess.check_call([
                    'hdiutil', 'convert', str(tmp_dmg),
                    '-format', 'UDZO',
                    '-o', str(final_dmg)
                ])
                if tmp_dmg.exists():
                    os.remove(tmp_dmg)
            except Exception as e:
                print(f"Warning: Failed to set DMG view options: {e}")
                # Fallback: just rename tmp_dmg if conversion/AppleScript failed
                if not final_dmg.exists():
                    os.rename(tmp_dmg, final_dmg)
            
            messagebox.showinfo("Success", f"Successfully created {final_dmg}")
            print(f"Successfully created {final_dmg}")

        finally:
            # Clean up staging directory
            try:
                if staging.exists():
                    shutil.rmtree(staging, ignore_errors=True)
                # Also clean up PyInstaller artifacts
                for d in ['build', 'dist']:
                    p_path = PROJECT_ROOT / d
                    if p_path.exists():
                        # Be careful not to delete 'dist' if it contains our final DMG
                        # However, create_dmg is usually run to build the DMG
                        # and PyInstaller artifacts are usually temporary in this context.
                        # We only remove them if they were created during this run.
                        pass
                spec_file = PROJECT_ROOT / f"{installer_name}.spec"
                if spec_file.exists():
                    os.remove(spec_file)
            except Exception:
                pass

    def open_dmg(self):
        """Reveal the created DMG in Finder without mounting it inline.

        This avoids blocking the installer process and lets macOS handle
        mounting/ejecting normally when the user opens the DMG.
        """
        if platform.system() != 'Darwin':
            return
        p = self._get_dmg_paths()
        dmg = p['final_dmg']
        if not dmg.exists():
            # Try to create it first
            self.create_dmg()
        # Reveal the DMG in Finder (non-blocking); do NOT attach/mount inline
        try:
            subprocess.run(['open', '-R', str(dmg)])
        except Exception:
            try:
                # Fallback: open the dist folder
                subprocess.run(['open', str(p['dist'])])
            except Exception:
                pass
    
    def create_install_screen(self):
        """Create the dependency installer screen"""
        frame = tk.Frame(self.content_area, bg='#1a1a1a')
        self.screens['install'] = frame
        
        # Title
        title = ttk.Label(frame, text="Install Dependencies", style='Title.TLabel')
        title.pack(pady=(0, 30))
        
        # Instructions
        instructions = tk.Label(frame,
                              text="Install the following dependencies to proceed with Prole deployment:",
                              bg='#1a1a1a',
                              fg='#aaaaaa',
                              font=('Helvetica', 11))
        instructions.pack(pady=(0, 20))
        
        # Dependencies list
        deps_frame = tk.Frame(frame, bg='#1a1a1a')
        deps_frame.pack(fill='both', expand=True)
        
        dependencies = [
            {
                'name': 'Docker',
                'description': 'Container platform for running Prole services',
                'url': 'https://www.docker.com/products/docker-desktop',
                'install_cmd': None,
                'check_cmd': 'docker --version'
            },
            {
                'name': 'Homebrew',
                'description': 'Package manager for macOS',
                'url': 'https://brew.sh',
                'install_cmd': '/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"',
                'check_cmd': 'brew --version'
            },
            {
                'name': 'k3d',
                'description': 'Lightweight wrapper to run k3s in Docker',
                'url': 'https://k3d.io',
                'install_cmd': 'brew install k3d',
                'check_cmd': 'k3d --version'
            },
            {
                'name': 'kubectl',
                'description': 'Kubernetes command-line tool',
                'url': 'https://kubernetes.io/docs/tasks/tools/',
                'install_cmd': 'brew install kubectl',
                'check_cmd': 'kubectl version --client'
            },
            {
                'name': 'Helm',
                'description': 'Kubernetes package manager',
                'url': 'https://helm.sh',
                'install_cmd': 'brew install helm',
                'check_cmd': 'helm version'
            },
            {
                'name': 'krew',
                'description': 'Kubectl plugin manager',
                'url': 'https://krew.sigs.k8s.io',
                'install_cmd': 'brew install krew',
                'check_cmd': 'kubectl krew version'
            },
            {
                'name': 'cmctl',
                'description': 'cert-manager CLI tool',
                'url': 'https://cert-manager.io',
                'install_cmd': 'brew install cmctl',
                'check_cmd': 'cmctl version'
            }
        ]
        
        self.dep_status = {}
        for dep in dependencies:
            self.create_dependency_card(deps_frame, dep)
        
        # Generate installer script button
        script_btn = tk.Button(frame,
                             text="Generate Installer Script",
                             command=self.generate_installer_script,
                             bg='#4a9eff',
                             fg='white',
                             activebackground='#3a8eef',
                             font=('Helvetica', 12, 'bold'),
                             padx=30,
                             pady=15,
                             cursor='hand2',
                             relief='flat')
        script_btn.pack(pady=20)
    
    def create_dependency_card(self, parent, dep):
        """Create a dependency card with status and download link"""
        card = tk.Frame(parent, bg='#2a2a2a', relief='flat', bd=1)
        card.pack(fill='x', pady=5, padx=10)
        
        # Left side - info
        info_frame = tk.Frame(card, bg='#2a2a2a')
        info_frame.pack(side='left', fill='both', expand=True, padx=15, pady=15)
        
        name_label = tk.Label(info_frame,
                            text=dep['name'],
                            bg='#2a2a2a',
                            fg='#ffffff',
                            font=('Helvetica', 13, 'bold'),
                            anchor='w')
        name_label.pack(fill='x')
        
        desc_label = tk.Label(info_frame,
                            text=dep['description'],
                            bg='#2a2a2a',
                            fg='#aaaaaa',
                            font=('Helvetica', 10),
                            anchor='w')
        desc_label.pack(fill='x', pady=(5, 0))
        
        # Right side - status and actions
        action_frame = tk.Frame(card, bg='#2a2a2a')
        action_frame.pack(side='right', padx=15, pady=15)
        
        # Status indicator
        status_label = tk.Label(action_frame,
                              text="Checking...",
                              bg='#2a2a2a',
                              fg='#ffaa00',
                              font=('Helvetica', 10))
        status_label.pack(side='left', padx=10)
        self.dep_status[dep['name']] = {'label': status_label, 'dep': dep}
        
        # Download button
        download_btn = tk.Button(action_frame,
                               text="Download",
                               command=lambda url=dep['url']: webbrowser.open(url),
                               bg='#28a745',
                               fg='white',
                               activebackground='#218838',
                               font=('Helvetica', 10),
                               padx=15,
                               pady=5,
                               cursor='hand2',
                               relief='flat')
        download_btn.pack(side='left', padx=5)
        
        # Check status
        self.check_dependency(dep['name'])
    
    def check_dependency(self, name):
        """Check if a dependency is installed"""
        dep_info = self.dep_status[name]
        dep = dep_info['dep']
        label = dep_info['label']
        
        def check():
            try:
                result = subprocess.run(dep['check_cmd'].split(),
                                      capture_output=True,
                                      text=True,
                                      timeout=5)
                if result.returncode == 0:
                    label.configure(text="✓ Installed", fg='#28a745')
                else:
                    label.configure(text="✗ Not Installed", fg='#dc3545')
            except Exception:
                label.configure(text="✗ Not Installed", fg='#dc3545')
        
        threading.Thread(target=check, daemon=True).start()
    
    def generate_installer_script(self):
        """Generate installer script by composing per-dependency templates from installer/scripts."""
        script_path = PROJECT_ROOT / 'install_dependencies.sh'
        scripts_dir = PROJECT_ROOT / 'installer' / 'scripts'

        # Expected order of templates
        expected = [
            'install_prole_homebrew.sh',
            'install_prole_k3d.sh',
            'install_prole_kubectl.sh',
            'install_prole_helm.sh',
            'install_prole_krew.sh',
            'install_prole_cmctl.sh',
            'install_prole_kubectl_plugins.sh',
        ]

        def _validate_and_strip(path: Path) -> str:
            """Validate template format and return content stripped of shebang and initial set -e* line."""
            try:
                text = path.read_text(encoding='utf-8')
            except Exception as e:
                raise RuntimeError(f"Failed to read {path.name}: {e}")

            lines = text.splitlines()
            if not lines:
                raise RuntimeError(f"Template {path.name} is empty")
            # Validate shebang
            if not lines[0].startswith('#!/bin/bash'):
                raise RuntimeError(f"Template {path.name} must start with #!/bin/bash")
            # Ensure there is a set -e or set -euo pipefail somewhere within first 10 lines
            has_set = any('set -e' in l for l in lines[:10])
            if not has_set:
                raise RuntimeError(f"Template {path.name} must set '-e' or 'set -euo pipefail'")
            # Strip shebang
            i = 1
            # Optionally strip empty/comment lines immediately after shebang
            while i < len(lines) and lines[i].strip() == '':
                i += 1
            # If next non-empty is a "set -e*" line, drop it to avoid duplicates in composed script
            if i < len(lines) and lines[i].lstrip().startswith('set -e'):
                i += 1
            body = "\n".join(lines[i:]).strip() + "\n"
            return body

        # Compose the final script
        errors: list[str] = []
        parts: list[str] = []

        header = (
            "#!/bin/bash\n"
            "# Prole Dependencies Installer Script\n"
            "# Generated by Prole Installer\n\n"
            "set -euo pipefail\n\n"
            "echo \"Installing Prole dependencies...\"\n\n"
        )
        parts.append(header)

        for fname in expected:
            p = scripts_dir / fname
            if not p.exists():
                errors.append(f"Missing template: {fname}")
                continue
            try:
                body = _validate_and_strip(p)
                parts.append(f"# ---- {fname} ----\n")
                parts.append(body)
                parts.append("\n")
            except Exception as e:
                errors.append(str(e))

        parts.append('echo "All dependencies installed successfully!"\n')

        if errors:
            messagebox.showerror("Template error", "\n".join(errors))
            return

        try:
            with open(script_path, 'w', encoding='utf-8', newline='\n') as f:
                f.write("".join(parts))
            os.chmod(script_path, 0o755)
            messagebox.showinfo("Success", 
                              f"Installer script generated at:\n{script_path}\n\n"
                              "You can run it with: ./install_dependencies.sh")
        except Exception as e:
            messagebox.showerror("Error", f"Failed to generate script: {str(e)}")
    
    def create_deploy_screen(self):
        """Create the Deploy screen"""
        frame = tk.Frame(self.content_area, bg='#1a1a1a')
        self.screens['deploy'] = frame
        
        # Title
        title = ttk.Label(frame, text="Build and Deploy", style='Title.TLabel')
        title.pack(pady=(0, 30))
        
        # Instructions
        instructions = tk.Label(frame,
                              text="Build and deploy Prole services to k3d cluster",
                              bg='#1a1a1a',
                              fg='#aaaaaa',
                              font=('Helvetica', 11))
        instructions.pack(pady=(0, 20))

        # Environment selector
        env_frame = tk.Frame(frame, bg='#1a1a1a')
        env_frame.pack(pady=(0, 10), fill='x')
        env_label = tk.Label(env_frame, text="Target Environment:", bg='#1a1a1a', fg='#dddddd', font=('Helvetica', 11))
        env_label.pack(side='left', padx=(0, 10))
        self.deploy_environment = tk.StringVar(value='Dev')
        env_combo = ttk.Combobox(env_frame, textvariable=self.deploy_environment, values=['Dev', 'Service', 'Prod'], state='readonly', width=18)
        env_combo.pack(side='left')
        env_help = tk.Label(env_frame,
                            text="Dev = local k3d (prole-dev-cluster), Service = remote k3s at retropie.prole.org:6443, Prod = stretch of prole-service-cluster",
                            bg='#1a1a1a', fg='#888888', font=('Helvetica', 9))
        env_help.pack(side='left', padx=(12, 0))
        
        # Deploy button
        deploy_btn = tk.Button(frame,
                             text="Build and Deploy",
                             command=self.start_deployment,
                             bg='#4a9eff',
                             fg='white',
                             activebackground='#3a8eef',
                             font=('Helvetica', 16, 'bold'),
                             padx=40,
                             pady=20,
                             cursor='hand2',
                             relief='flat')
        deploy_btn.pack(pady=20)
        
        # Progress frame
        progress_frame = tk.Frame(frame, bg='#1a1a1a')
        progress_frame.pack(fill='both', expand=True, pady=20)
        
        # Progress list
        # Initialize deploy steps; some names are updated dynamically when deployment starts
        self.deploy_steps = [
            {'name': 'Build ProleStatus macOS app', 'status': 'pending'},
            {'name': 'Check Docker is running', 'status': 'pending'},
            {'name': 'Check or configure container registry', 'status': 'pending'},
            {'name': 'Ensure target cluster', 'status': 'pending'},
            {'name': 'Build prole-db Docker image', 'status': 'pending'},
            {'name': 'Tag Docker image for registry', 'status': 'pending'},
            {'name': 'Push image to registry', 'status': 'pending'},
            {'name': 'Import image to k3d cluster (Dev only)', 'status': 'pending'},
        ]
        
        self.deploy_widgets = {}
        for step in self.deploy_steps:
            self.create_deploy_step_widget(progress_frame, step)
    
    def create_deploy_step_widget(self, parent, step):
        """Create a widget for a deployment step"""
        step_frame = tk.Frame(parent, bg='#2a2a2a', relief='flat')
        step_frame.pack(fill='x', pady=5, padx=10)
        
        # Status indicator
        status_canvas = tk.Canvas(step_frame, width=30, height=30, bg='#2a2a2a', highlightthickness=0)
        status_canvas.pack(side='left', padx=15, pady=15)
        
        # Step name
        name_label = tk.Label(step_frame,
                            text=step['name'],
                            bg='#2a2a2a',
                            fg='#ffffff',
                            font=('Helvetica', 11),
                            anchor='w')
        name_label.pack(side='left', fill='x', expand=True, padx=10)
        
        # Status text
        status_label = tk.Label(step_frame,
                              text="Pending",
                              bg='#2a2a2a',
                              fg='#aaaaaa',
                              font=('Helvetica', 10))
        status_label.pack(side='right', padx=15)
        
        self.deploy_widgets[step['name']] = {
            'canvas': status_canvas,
            'label': status_label,
            'step': step
        }
        
        # Draw initial pending state
        self.update_deploy_step_status(step['name'], 'pending')
    
    def update_deploy_step_status(self, step_name, status):
        """Update the status of a deployment step"""
        widget = self.deploy_widgets[step_name]
        canvas = widget['canvas']
        label = widget['label']
        step = widget['step']
        
        step['status'] = status
        canvas.delete('all')
        
        if status == 'pending':
            ui.canvas_oval_on(canvas, 5, 5, 25, 25, outline='#666', width=2)
            label.configure(text="Pending", fg='#aaaaaa')
        elif status == 'running':
            ui.canvas_oval_on(canvas, 5, 5, 25, 25, outline='#ffaa00', width=2, fill='#ffaa00')
            label.configure(text="Running...", fg='#ffaa00')
        elif status == 'completed':
            ui.canvas_oval_on(canvas, 5, 5, 25, 25, outline='#28a745', width=2, fill='#28a745')
            ui.canvas_text_on(canvas, 15, 15, '✓', fill='white', font=('Helvetica', 16, 'bold'))
            label.configure(text="Completed", fg='#28a745')
        elif status == 'error':
            ui.canvas_oval_on(canvas, 5, 5, 25, 25, outline='#dc3545', width=2, fill='#dc3545')
            ui.canvas_text_on(canvas, 15, 15, '✗', fill='white', font=('Helvetica', 16, 'bold'))
            label.configure(text="Error", fg='#dc3545')
        elif status == 'skipped':
            ui.canvas_oval_on(canvas, 5, 5, 25, 25, outline='#666', width=2, fill='#444444')
            label.configure(text="Skipped", fg='#888888')
    
    def start_deployment(self):
        """Start the deployment process"""
        threading.Thread(target=self.run_deployment, daemon=True).start()
    
    def generate_prole_properties(self, env: str):
        """Dynamically generate prole-tools-app/prole.properties based on environment"""
        props_path = Path("prole-tools-app/prole.properties")
        
        # Determine host based on environment
        # For now use localhost as a placeholder for Service/Prod
        host = "localhost" 
        
        content = f"""# Prole default endpoints (dynamically generated by install.py)
# UI assets
icon=img/proleIcon.png
background=img/proleLogoSepia.png

# Dev port-forward supervision
pf.enabled=true

# Service endpoints (5 traffic lights)
svc.1.name=K3D
svc.1.host={host}
svc.1.port=6443

svc.2.name=Prometheus
svc.2.host={host}
svc.2.port=9090

svc.3.name=Grafana
svc.3.host={host}
svc.3.port=3000

svc.4.name=OpenBAO
svc.4.host={host}
svc.4.port=8200

svc.5.name=PostgreSQL
svc.5.host={host}
svc.5.port=5432

# Kerberos configuration
kerberos.enabled={str(self.kerberos_enabled.get()).lower()}
kerberos.realm={self.kerberos_realm.get()}
kerberos.user={self.kerberos_user.get()}
kerberos.kdc={self.kerberos_kdc.get()}
"""
        props_path.write_text(content)
        print(f"Generated {props_path} for {env} environment")

    def run_deployment(self):
        """Run the deployment steps"""
        try:
            # Capture environment selection and prepare dynamic labels
            env = self.deploy_environment.get().strip()
            if env not in ('Dev', 'Service', 'Prod'):
                env = 'Dev'
            
            # Update step labels to reflect environment
            self.deploy_widgets['Ensure target cluster']['step']['name'] = f"Ensure target cluster ({env})"
            # Use the correct way to update the label text in the UI
            self.deploy_widgets['Ensure target cluster']['label'].master.winfo_children()[1].configure(text=f"Ensure target cluster ({env})")

            # Step 0: Generate prole.properties
            self.generate_prole_properties(env)

            # Step 1: Build Prole macOS app
            self.update_deploy_step_status('Build Prole macOS app', 'running')
            self.build_prole_app()
            self.update_deploy_step_status('Build Prole macOS app', 'completed')

            # Step 1: Check Docker
            self.update_deploy_step_status('Check Docker is running', 'running')
            if not self.check_docker_running():
                self.update_deploy_step_status('Check Docker is running', 'error')
                messagebox.showerror("Error", "Docker is not running. Please start Docker Desktop.")
                return
            self.update_deploy_step_status('Check Docker is running', 'completed')

            # Step 2: Registry discovery/config
            self.update_deploy_step_status('Check or configure container registry', 'running')
            self.registry_url = self.ensure_registry_available(env)
            self.update_deploy_step_status('Check or configure container registry', 'completed')

            # Step 3: Ensure target cluster as per environment
            self.update_deploy_step_status('Ensure target cluster', 'running')
            self.create_or_select_cluster(env)
            self.update_deploy_step_status('Ensure target cluster', 'completed')
            
            # Step 3: Build Docker image
            self.update_deploy_step_status('Build prole-db Docker image', 'running')
            self.build_docker_image()
            self.update_deploy_step_status('Build prole-db Docker image', 'completed')
            
            # Step 4: Tag image
            self.update_deploy_step_status('Tag Docker image for registry', 'running')
            self.tag_docker_image()
            self.update_deploy_step_status('Tag Docker image for registry', 'completed')
            
            # Step 5: Push to registry
            self.update_deploy_step_status('Push image to registry', 'running')
            self.push_docker_image()
            self.update_deploy_step_status('Push image to registry', 'completed')
            
            # Step 6: Import to k3d (Dev only)
            if env == 'Dev':
                self.update_deploy_step_status('Import image to k3d cluster (Dev only)', 'running')
                self.import_k3d_image(cluster_name='prole-dev-cluster')
                self.update_deploy_step_status('Import image to k3d cluster (Dev only)', 'completed')
            else:
                self.update_deploy_step_status('Import image to k3d cluster (Dev only)', 'skipped')

            # Step 7: Install LaunchAgent for port-forwards (Dev)
            if env == 'Dev':
                self.update_deploy_step_status('Install LaunchAgent for port-forwards (Dev)', 'running')
                ok = self.install_launchagent_port_forwards()
                if ok:
                    self.update_deploy_step_status('Install LaunchAgent for port-forwards (Dev)', 'completed')
                else:
                    self.update_deploy_step_status('Install LaunchAgent for port-forwards (Dev)', 'error')
                    return
            else:
                self.update_deploy_step_status('Install LaunchAgent for port-forwards (Dev)', 'skipped')
            
            messagebox.showinfo("Success", "Deployment completed successfully!")
            
        except Exception as e:
            messagebox.showerror("Error", f"Deployment failed: {str(e)}")

    def install_launchagent_port_forwards(self) -> bool:
        """Create/update the user LaunchAgent and helper script to manage kubectl port-forwards.
        - Helper script: ~/Library/Application Support/Prole/bin/prole-kpf.sh
        - LaunchAgent:   ~/Library/LaunchAgents/org.prole.prole-db.kpf-dev.plist
        """
        try:
            home = Path.home()
            bin_dir = home / 'Library' / 'Application Support' / 'Prole' / 'bin'
            run_dir = home / 'Library' / 'Application Support' / 'Prole' / 'run'
            plist_path = home / 'Library' / 'LaunchAgents' / 'org.prole.prole-db.kpf-dev.plist'
            script_path = bin_dir / 'prole-kpf.sh'

            bin_dir.mkdir(parents=True, exist_ok=True)
            run_dir.mkdir(parents=True, exist_ok=True)
            plist_path.parent.mkdir(parents=True, exist_ok=True)

            helper_script = """#!/bin/sh
set -eu

LABEL="org.prole.prole-db.kpf-dev"
PLIST="$HOME/Library/LaunchAgents/$LABEL.plist"
RUNDIR="$HOME/Library/Application Support/Prole/run"
PIDFILE="$RUNDIR/kpf.pids"

ensure_rundir() {
  mkdir -p "$RUNDIR"
}

list_cmds() {
  # Enumerate ProleCommands array using PlistBuddy
  if /usr/libexec/PlistBuddy -c "Print :ProleCommands" "$PLIST" >/dev/null 2>&1; then
    i=0
    while true; do
      if ! val=$(/usr/libexec/PlistBuddy -c "Print :ProleCommands:$i" "$PLIST" 2>/dev/null); then
        break
      fi
      echo "$val"
      i=$((i+1))
    done
  fi
}

start() {
  ensure_rundir
  : > "$PIDFILE"
  IFS='\n'
  for cmd in $(list_cmds); do
    [ -z "$cmd" ] && continue
    (sh -lc "$cmd") &
    echo $! >> "$PIDFILE"
  done
  wait
}

stop() {
  if [ -f "$PIDFILE" ]; then
    while read -r pid; do
      [ -z "$pid" ] && continue
      kill "$pid" 2>/dev/null || true
    done < "$PIDFILE"
    rm -f "$PIDFILE"
  fi
}

status() {
  if [ ! -f "$PIDFILE" ]; then
    echo "not running"
    exit 3
  fi
  alive=0
  total=0
  while read -r pid; do
    [ -z "$pid" ] && continue
    total=$((total+1))
    if kill -0 "$pid" 2>/dev/null; then alive=$((alive+1)); fi
  done < "$PIDFILE"
  echo "$alive/$total running"
}

case "${1:-}" in
  start) start ;;
  stop) stop ;;
  restart) stop; start ;;
  status) status ;;
  *) echo "Usage: $0 {start|stop|restart|status}" >&2; exit 2 ;;
esac
"""

            script_path.write_text(helper_script)
            os.chmod(script_path, 0o755)

            # Default commands for Dev environment (k3d)
            default_cmds = [
                "kubectl port-forward svc/prometheus-community-kube-prometheus 9090",
                "kubectl -n kubernetes-dashboard port-forward svc/kubernetes-dashboard-kong-proxy 8443:443",
                "kubectl port-forward svc/prole-db-rw 5432:5432 --address 0.0.0.0",
                "kubectl port-forward svc/prometheus-community-grafana 3000:80 --address 0.0.0.0",
            ]

            # Create plist dict
            from plistlib import dumps as plist_dumps
            plist_dict = {
                'Label': 'org.prole.prole-db.kpf-dev',
                'RunAtLoad': True,
                'KeepAlive': True,
                # Ensure PATH has common locations for kubectl
                'EnvironmentVariables': {
                    'PATH': os.environ.get('PATH', '/usr/local/bin:/usr/bin:/bin')
                },
                'StandardOutPath': str(home / 'Library' / 'Logs' / 'org.prole.prole-db.kpf-dev.out.log'),
                'StandardErrorPath': str(home / 'Library' / 'Logs' / 'org.prole.prole-db.kpf-dev.err.log'),
                'ProgramArguments': [str(script_path), 'start'],
                'ProleCommands': default_cmds,
            }

            plist_bytes = plist_dumps(plist_dict)
            plist_path.write_bytes(plist_bytes)

            # Reload the agent
            uid = os.getuid()
            # Try to kickstart first
            subprocess.run(['launchctl', 'kickstart', '-k', f'gui/{uid}/org.prole.prole-db.kpf-dev'], capture_output=True)
            # Bootout and bootstrap to ensure it's loaded, then kickstart
            subprocess.run(['launchctl', 'bootout', f'gui/{uid}', f'gui/{uid}/org.prole.prole-db.kpf-dev'], capture_output=True)
            subprocess.run(['launchctl', 'bootstrap', f'gui/{uid}', str(plist_path)], check=True)
            subprocess.run(['launchctl', 'kickstart', '-k', f'gui/{uid}/org.prole.prole-db.kpf-dev'], check=True)

            return True
        except Exception as e:
            print(f"LaunchAgent setup failed: {e}")
            return False


    def check_xcode_tools(self):
        """Check if Xcode Command Line Tools are installed via deploy helper."""
        return inst_deploy.check_xcode_tools()

    def build_prole_app(self):
        """Delegate building the native ProleStatus app to deploy helper."""
        return inst_deploy.build_prole_app(PROJECT_ROOT)
    
    def check_docker_running(self):
        """Check if Docker is running"""
        try:
            result = subprocess.run(['docker', 'ps'],
                                  capture_output=True,
                                  timeout=10)
            return result.returncode == 0
        except Exception:
            return False
    
    def ensure_registry_available(self, env: str) -> str:
        """Detect if k8s.prole.org:5000 is reachable; if so use it. Otherwise ensure a local registry is available.
        Returns the registry URL (host:port) to be used for tagging/pushing.
        For Dev, may create a local k3d-managed registry; for other envs, still prefer the external if reachable.
        """
        def http_ping_registry(host: str, port: int) -> bool:
            try:
                import http.client
                conn = http.client.HTTPConnection(host, port, timeout=3)
                conn.request('GET', '/v2/')
                resp = conn.getresponse()
                # Docker registry typically returns 200 or 401 for /v2/
                return resp.status in (200, 401)
            except Exception:
                return False

        # Prefer the shared registry if reachable
        if http_ping_registry('k8s.prole.org', 5000):
            return 'k8s.prole.org:5000'

        # Otherwise, ensure a local registry (localhost:5000) exists/started
        # Use k3d registry helper for Dev; for non-Dev, we still create/use local for pushing
        reg_name = 'prole-registry'
        # Check if k3d is installed
        k3d_exists = subprocess.run(['which', 'k3d'], capture_output=True).returncode == 0
        if k3d_exists:
            # List registries
            lst = subprocess.run(['k3d', 'registry', 'list'], capture_output=True, text=True)
            if reg_name not in (lst.stdout or ''):
                # Create registry exposed on 0.0.0.0:5000
                subprocess.run(['k3d', 'registry', 'create', reg_name, '--port', '0.0.0.0:5000'], check=True)
        return 'localhost:5000'

    def ensure_local_registry_available(self):
        """Ensure a local k3d registry is running and return (host_registry, cluster_registry)."""
        reg_name = 'prole-registry'
        registry_container = f'k3d-{reg_name}'
        host_registry = 'localhost:5000'
        cluster_registry = f'{registry_container}.localhost:5000'

        if not self.check_docker_running():
            return None

        # Require k3d to manage the local registry
        k3d_exists = subprocess.run(['which', 'k3d'], capture_output=True).returncode == 0
        if not k3d_exists:
            return None

        # Ensure registry exists
        lst = subprocess.run(['k3d', 'registry', 'list'], capture_output=True, text=True)
        if registry_container not in (lst.stdout or '') and reg_name not in (lst.stdout or ''):
            subprocess.run(['k3d', 'registry', 'create', reg_name, '--port', '0.0.0.0:5000'], check=True)

        # Ensure registry container is running
        running = subprocess.run(
            ['docker', 'ps', '--filter', f'name={registry_container}', '--format', '{{.Names}}'],
            capture_output=True, text=True
        )
        if not (running.stdout or '').strip():
            exists = subprocess.run(
                ['docker', 'ps', '-a', '--filter', f'name={registry_container}', '--format', '{{.Names}}'],
                capture_output=True, text=True
            )
            if (exists.stdout or '').strip():
                subprocess.run(['docker', 'start', registry_container], check=True)

        # Persist for later steps
        self.local_registry_url = host_registry
        self.local_registry_internal = cluster_registry
        try:
            self.prole_cfg_data['Docker Build']['LOCAL_REGISTRY'] = host_registry
            self.prole_cfg_data['Docker Build']['LOCAL_REGISTRY_INTERNAL'] = cluster_registry
            self.safe_after(self._save_prole_cfg)
        except Exception:
            pass

        return host_registry, cluster_registry

    def _collect_dependent_images(self, include_supabase: bool, include_kerberos_proxy: bool) -> list[str]:
        images = set()
        for rel_dir in ('k8s/prole', 'k8s/openbao'):
            base_dir = PROJECT_ROOT / rel_dir
            if not base_dir.exists():
                continue
            images.update(_collect_images_from_files(list(base_dir.glob('*.yaml'))))

        if include_supabase:
            supa_home = _resolve_supabase_home(PROJECT_ROOT)
            if supa_home:
                docker_dir = supa_home / 'docker'
                compose_files = [docker_dir / 'docker-compose.yml']
                if os.environ.get('SUPABASE_USE_DEV_COMPOSE') == '1':
                    compose_files.append(docker_dir / 'dev' / 'docker-compose.dev.yml')
                images.update(_collect_images_from_files(compose_files))

        if not include_supabase:
            images = {img for img in images if 'supabase' not in img}

        if include_kerberos_proxy:
            krb_img = os.environ.get('KRB5_AD_PROXY_IMAGE', 'alpine/socat')
            if krb_img:
                images.add(krb_img)

        return sorted(images)

    def _prepull_images_to_registry(self, include_supabase: bool, include_kerberos_proxy: bool, log=None) -> bool:
        def _log(msg: str):
            if log:
                try:
                    log(msg)
                except Exception:
                    pass

        info = self.ensure_local_registry_available()
        if not info:
            _log("Local registry unavailable; skipping image pre-pull.\n")
            return False

        registry, _cluster_registry = info
        images = self._collect_dependent_images(include_supabase, include_kerberos_proxy)
        if not images:
            _log("No dependent images found to pre-pull.\n")
            return True

        overall_ok = True
        for image in images:
            _log(f"\nPulling {image}...\n")
            pull = subprocess.run(['docker', 'pull', image], capture_output=True, text=True)
            if pull.returncode != 0:
                overall_ok = False
                _log(pull.stdout or '')
                _log(pull.stderr or '')
                _log(f"[ERROR] docker pull failed for {image}\n")
                continue

            local_tag = image
            if not image.startswith(f"{registry}/"):
                local_tag = f"{registry}/{image}"
                tag = subprocess.run(['docker', 'tag', image, local_tag], capture_output=True, text=True)
                if tag.returncode != 0:
                    overall_ok = False
                    _log(tag.stdout or '')
                    _log(tag.stderr or '')
                    _log(f"[ERROR] docker tag failed for {image}\n")
                    continue

            push = subprocess.run(['docker', 'push', local_tag], capture_output=True, text=True)
            if push.returncode != 0:
                overall_ok = False
                _log(push.stdout or '')
                _log(push.stderr or '')
                _log(f"[ERROR] docker push failed for {local_tag}\n")
                continue
            _log(f"[OK] Stored {image} in local registry as {local_tag}\n")

        return overall_ok

    def create_or_select_cluster(self, env: str):
        """Ensure target cluster depending on environment selection."""
        if env == 'Dev':
            self.create_or_recreate_k3d_dev_cluster()
        elif env in ('Service', 'Prod'):
            # For now, just check kubectl availability and inform user. Real connectivity requires kubeconfig.
            kubectl = subprocess.run(['which', 'kubectl'], capture_output=True)
            if kubectl.returncode != 0:
                raise Exception("kubectl not found. Please install kubectl and configure access to the target cluster.")
            # Optionally, try a quick cluster-info; don't fail hard on auth errors.
            subprocess.run(['kubectl', 'version', '--client'], check=True)
        else:
            raise Exception(f"Unknown environment: {env}")

    def create_or_recreate_k3d_dev_cluster(self):
        """Create or restart local k3d cluster named prole-dev-cluster and wire it to the chosen registry."""
        cluster_name = 'prole-dev-cluster'
        result = subprocess.run(['k3d', 'cluster', 'list'], capture_output=True, text=True)
        if cluster_name in (result.stdout or ''):
            subprocess.run(['k3d', 'cluster', 'delete', cluster_name], check=True)

        # Determine registry integration args
        reg_args = []
        if getattr(self, 'registry_url', None):
            # If using the local k3d registry, we want to create or use it
            if self.registry_url.startswith('localhost:5000'):
                # Creating with --registry-create ensures it's available and integrated
                reg_args = ['--registry-create', f'prole-registry:0.0.0.0:5000']
            else:
                reg_args = ['--registry-use', self.registry_url]

        cmd = ['k3d', 'cluster', 'create', cluster_name, '-a', '2', '--wait'] + reg_args + ['--timestamps']
        subprocess.run(cmd, check=True, cwd=PROJECT_ROOT)
    
    def get_prole_db_version(self):
        return self.controller.get_prole_db_version()

    def build_docker_image(self):
        """Build prole-db Docker image"""
        # If Kerberos is enabled, update pg_hba.conf in conf/postgresql before copying
        if self.kerberos_enabled.get():
            realm = self.kerberos_realm.get().strip() or "EXAMPLE.COM"
            hba_src = PROJECT_ROOT / 'conf' / 'postgresql' / 'pg_hba.conf'
            if hba_src.exists():
                content = hba_src.read_text()
                # Also ensure the Kerberos line exists in the source if it's not there yet
                if "gss" not in content:
                    content += f"\nhost    all             all             all                     gss include_realm=1 krb_realm={realm}\n"
                else:
                    content = content.replace("krb_realm=EXAMPLE.COM", f"krb_realm={realm}")
                hba_src.write_text(content)
                print(f"Updated {hba_src} with realm {realm}")

        # Base local image tag (before pushing to registry)
        version = self.get_prole_db_version()
        image_tag = f'prole-db:{version}'
        
        # Prepare build context: copy conf/postgresql to prole-db/postgresql
        conf_src = PROJECT_ROOT / 'conf' / 'postgresql'
        conf_dst = PROJECT_ROOT / 'prole-db' / 'postgresql'
        
        if conf_dst.exists():
            shutil.rmtree(conf_dst, ignore_errors=True)
        if sys.version_info >= (3, 8):
            shutil.copytree(conf_src, conf_dst, dirs_exist_ok=True)
        else:
            shutil.copytree(conf_src, conf_dst)
        
        build_cmd = ['docker', 'build', '-t', image_tag]
        
        # Add platform flag for Apple Silicon (ARM64 needs amd64 for compatibility)
        build_cmd.extend(get_docker_build_platform_args())
        
        build_cmd.append('.')
        
        result = subprocess.run(build_cmd,
                              check=True,
                              cwd=PROJECT_ROOT / 'prole-db',
                              capture_output=True,
                              text=True)
        if result.returncode != 0:
            raise Exception(f"Failed to build image: {result.stderr}")
        # Keep a reference for later steps
        self.local_image_tag = image_tag

        # Update K8s manifest
        self.update_k8s_manifest(image_tag)
    
    def update_k8s_manifest(self, image_tag):
        """Update k8s/prole/prole-db.yaml with the new version and Kerberos config"""
        manifest_paths = [
            PROJECT_ROOT / 'k8s' / 'prole' / 'prole-db.yaml',
            PROJECT_ROOT / 'k8s' / 'prole' / 'prole-db-recovery.yaml.tpl',
        ]
        import re
        for manifest_path in manifest_paths:
            if not manifest_path.exists():
                continue
            content = manifest_path.read_text()
            # Update imageName: prole-db:17.7-043
            new_content = re.sub(r'imageName:\s*.*', f'imageName: {image_tag}', content)
        
            # Update Kerberos realm in manifest if enabled
            if self.kerberos_enabled.get():
                realm = self.kerberos_realm.get().strip() or "EXAMPLE.COM"
                if "gss" not in new_content:
                    # Insert before bootstrap if not present
                    new_content = new_content.replace("    pg_hba:", f"    pg_hba:\n      - host all all all gss include_realm=1 krb_realm={realm}")
                else:
                    new_content = new_content.replace("krb_realm=EXAMPLE.COM", f"krb_realm={realm}")

            if new_content != content:
                manifest_path.write_text(new_content)
    
    def build_mssql_docker_image(self, image_tag='prole-mssql-db:latest'):
        """Build mssql Docker image (with platform detection for Apple Silicon)"""
        build_cmd = ['docker', 'build', '-t', image_tag]
        
        # Add platform flag for Apple Silicon (mssql requires amd64)
        build_cmd.extend(get_docker_build_platform_args())
        
        build_cmd.append('.')
        
        result = subprocess.run(build_cmd,
                              check=True,
                              cwd=PROJECT_ROOT / 'mssql',
                              capture_output=True,
                              text=True)
        if result.returncode != 0:
            raise Exception(f"Failed to build mssql image: {result.stderr}")
        return result
    
    def tag_docker_image(self):
        """Tag Docker image for registry"""
        version = self.get_prole_db_version()
        registry = getattr(self, 'registry_url', 'localhost:5000')
        image_name = f'prole-db:{version}'
        image = getattr(self, 'local_image_tag', image_name)
        self.remote_image_tag = f"{registry}/prole-db:{version}"
        subprocess.run(['docker', 'tag', image, self.remote_image_tag], check=True, capture_output=True)
    
    def push_docker_image(self):
        """Push Docker image to registry"""
        remote_tag = getattr(self, 'remote_image_tag', None)
        if not remote_tag:
            raise Exception('Remote image tag not set')
        result = subprocess.run(['docker', 'push', remote_tag], check=True, capture_output=True, text=True)
        if result.returncode != 0:
            raise Exception(f"Failed to push image: {result.stderr}")
    
    def import_k3d_image(self, cluster_name='prole-dev-cluster'):
        """Import image to k3d cluster (only for Dev)."""
        version = self.get_prole_db_version()
        image_name = f'prole-db:{version}'
        subprocess.run(['k3d', 'image', 'import', image_name, '-c', cluster_name], check=True, capture_output=True)
    
    def create_validate_screen(self):
        """Create the Validate screen"""
        frame = self._page_container()
        self.screens['validate'] = frame
        
        # Title
        title = ttk.Label(frame, text="Validate Deployment", style='Title.TLabel')
        title.pack(pady=(0, 20))
        
        # Prometheus link
        prometheus_frame = tk.Frame(frame, bg='white')
        prometheus_frame.pack(pady=(0, 20))
        
        prometheus_label = tk.Label(prometheus_frame,
                                  text="Prometheus: ",
                                  bg='white',
                                  fg='#6e6e73',
                                  font=('Helvetica', 11))
        prometheus_label.pack(side='left')
        
        prometheus_link = tk.Label(prometheus_frame,
                                 text="http://localhost:9090",
                                 bg='white',
                                 fg='#4a9eff',
                                 font=('Helvetica', 11, 'underline'),
                                 cursor='hand2')
        prometheus_link.pack(side='left')
        prometheus_link.bind('<Button-1>', lambda e: webbrowser.open('http://localhost:9090'))
        
        # Status display
        status_frame = tk.Frame(frame, bg='white')
        status_frame.pack(fill='both', expand=True, pady=10)
        
        status_label = ttk.Label(status_frame, text="Cluster Status", style='Heading.TLabel')
        status_label.pack(anchor='w', pady=(0, 10))
        
        # Status text area - using TerminalConsole for consistency
        # Use a background frame to ensure NO borders are visible around the console
        console_bg = tk.Frame(status_frame, bg='white', highlightthickness=0, bd=0)
        console_bg.pack(fill='both', expand=True, padx=1, pady=1)
        self._validation_console = ui.TerminalConsole(console_bg, highlightthickness=0, bd=0)
        self._validation_console.pack(fill='both', expand=True)
        self.status_text = self._validation_console.text
        
        # Auto-refresh checkbox
        refresh_frame = tk.Frame(frame, bg='white')
        refresh_frame.pack(pady=10)
        
        self.auto_refresh_var = tk.BooleanVar(value=True)
        refresh_check = tk.Checkbutton(refresh_frame,
                                      text="Auto-refresh every 10 seconds",
                                      variable=self.auto_refresh_var,
                                      bg='white',
                                      fg='#1d1d1f',
                                      selectcolor='#f0f0f0',
                                      activebackground='white',
                                      activeforeground='#1d1d1f',
                                      font=('Helvetica', 10),
                                      command=self.toggle_auto_refresh)
        refresh_check.pack(side='left', padx=10)
        
        # Manual refresh button
        refresh_btn = tk.Button(refresh_frame,
                              text="Refresh Now",
                              command=self.refresh_status,
                              bg='#4a9eff',
                              fg='white',
                              activebackground='#3a8eef',
                              highlightbackground='white',
                              font=('Helvetica', 10),
                              padx=15,
                              pady=5,
                              cursor='hand2',
                              relief='flat')
        refresh_btn.pack(side='left', padx=10)
        
        # Start auto-refresh
        self.refresh_status()
        self.toggle_auto_refresh()
    
    def toggle_auto_refresh(self):
        """Toggle auto-refresh"""
        if self.auto_refresh_var.get():
            if not self.validation_running:
                self.validation_running = True
                self.validation_thread = threading.Thread(target=self.auto_refresh_loop, daemon=True)
                self.validation_thread.start()
        else:
            self.validation_running = False
    
    def auto_refresh_loop(self):
        """Auto-refresh loop"""
        while self.validation_running:
            time.sleep(10)
            if self.validation_running:
                self.root.after(0, self.refresh_status)
    
    def refresh_status(self):
        """Refresh the cluster status"""
        def update():
            try:
                full_status = ""
                
                # Get k3d cluster list
                try:
                    cluster_result = subprocess.run(['k3d', 'cluster', 'list'],
                                                  capture_output=True,
                                                  text=True,
                                                  timeout=5)
                    full_status += f"=== k3d Cluster Status ===\n{cluster_result.stdout}\n\n"
                except Exception as e:
                    full_status += f"=== k3d Cluster Status ===\nError: {str(e)}\n\n"
                
                # Get kubectl cnpg status
                try:
                    namespace = (self.db_namespace.get() or 'default').strip()
                    result = subprocess.run(['kubectl', 'cnpg', 'status', 'prole-db', '-n', namespace],
                                          capture_output=True,
                                          text=True,
                                          timeout=10)
                    if result.returncode == 0:
                        status_output = result.stdout
                    else:
                        # Try default namespace if prole fails, or just show error
                        status_output = f"Error: {result.stderr}\n\nNote: Make sure kubectl cnpg plugin is installed and cluster exists in '{namespace}' namespace."
                    
                    full_status += f"=== CloudNativePG Status (namespace: {namespace}) ===\n{status_output}\n"
                except FileNotFoundError:
                    full_status += "=== CloudNativePG Status ===\nError: kubectl not found. Please install dependencies first.\n"
                except subprocess.TimeoutExpired:
                    full_status += "=== CloudNativePG Status ===\nError: Command timed out\n"
                except Exception as e:
                    full_status += f"=== CloudNativePG Status ===\nError: {str(e)}\n"
                
                full_status += f"\nLast updated: {time.strftime('%Y-%m-%d %H:%M:%S')}"
                
                self.status_text.delete('1.0', tk.END)
                self.status_text.insert('1.0', full_status)
                
            except Exception as e:
                self.status_text.delete('1.0', tk.END)
                self.status_text.insert('1.0', f"Error: {str(e)}")
        
        threading.Thread(target=update, daemon=True).start()


def _configure_unbuffered_io():
    os.environ.setdefault('PYTHONUNBUFFERED', '1')
    for stream in (sys.stdout, sys.stderr):
        try:
            stream.reconfigure(line_buffering=True, write_through=True)
        except Exception:
            try:
                stream.flush()
            except Exception:
                pass


class ProleSilentInstaller:
    """Console-based unattended installer driven by prole.cfg inputs."""

    def __init__(self, controller: ProleController, cfg_path: str | None = None):
        self.controller = controller
        self.project_root = controller.project_root
        self.dependencies = list(inst_config.DEPENDENCIES)
        self.cfg_path = self._normalize_cfg_path(cfg_path)
        self.inputs = {}
        self.prole_cfg_data = {
            'Global': {},
            'Welcome': {},
            'Dependencies': {},
            'Network': {},
            'System Environment': {},
            'Kerberos Authentication': {},
            'Optional Features': {},
            'Database Creation': {},
            'Docker Build': {},
            'Initialize Cluster': {},
            'Initialization Scripts': {},
            'Prole DB Deploy': {},
            'Install': {}
        }
        self._db_built_success = False
        self._scripts_success = False
        self._cnpg_success = False

    # ---------------- Logging helpers ----------------
    def log(self, msg: str):
        print(msg, flush=True)

    def err(self, msg: str):
        print(msg, file=sys.stderr, flush=True)

    # ---------------- Config helpers ----------------
    def _normalize_cfg_path(self, raw: str | None) -> Path:
        if raw:
            p = Path(_expand_path(raw))
            if p.is_dir():
                return p / 'prole.cfg'
            return p
        prole_conf = os.environ.get('PROLE_CONF')
        if prole_conf:
            return Path(_expand_path(prole_conf)) / 'prole.cfg'
        return self.project_root / 'prole' / 'conf' / 'prole.cfg'

    def _load_inputs_from_cfg(self) -> dict:
        cfg = configparser.ConfigParser(interpolation=None)
        cfg.optionxform = str
        if not self.cfg_path.exists():
            raise FileNotFoundError(f"prole.cfg not found at {self.cfg_path}")
        cfg.read(self.cfg_path)
        self._auto_input_keys = set()
        auto_kdc = None
        auto_enabled = None
        if cfg.has_section('Network'):
            sec = cfg['Network']
            if 'KDC_AUTO_DETECTED' in sec:
                auto_kdc = sec.get('KDC_AUTO_DETECTED', '')
            if 'KERBEROS_AUTO_ENABLED' in sec:
                auto_enabled = sec.get('KERBEROS_AUTO_ENABLED', '')

        def mark_auto(inputs: dict):
            if auto_kdc:
                if inputs.get('kerberos_config.kdc', '').strip() == str(auto_kdc).strip():
                    self._auto_input_keys.add('kerberos_config.kdc')
            if auto_enabled is not None:
                input_enabled = inputs.get('kerberos_config.enabled')
                input_bool = _parse_bool(input_enabled, None)
                auto_bool = _parse_bool(auto_enabled, None)
                if input_bool is not None and auto_bool is not None and input_bool == auto_bool:
                    self._auto_input_keys.add('kerberos_config.enabled')
        inputs: dict[str, str] = {}
        if cfg.has_section('Inputs'):
            inputs.update({k: v for k, v in cfg.items('Inputs')})
            mark_auto(inputs)
            return inputs
        # Legacy fallback mapping
        legacy = {}
        if cfg.has_section('System Environment'):
            sec = cfg['System Environment']
            for k in ('PROLE_HOME', 'PROLE_CONF', 'PROLE_DATA', 'PROLE_LOGS', 'PROLE_SERVICE'):
                if k in sec:
                    legacy[f'env_setup.{k}'] = sec.get(k, '')
        if cfg.has_section('Global'):
            sec = cfg['Global']
            if 'PROLE_HOME' in sec:
                legacy['env_setup.PROLE_HOME'] = sec.get('PROLE_HOME', '')
            if 'CLUSTER_ENV' in sec:
                legacy['init_cluster.cluster_env'] = sec.get('CLUSTER_ENV', '')
            if 'NAMESPACE' in sec:
                legacy['init_password.db_namespace'] = sec.get('NAMESPACE', '')
                legacy['env_setup.NAMESPACE'] = sec.get('NAMESPACE', '')
            if 'PROLE_DB_USER' in sec:
                legacy['init_password.db_username'] = sec.get('PROLE_DB_USER', '')
            if 'DB_PASSWORD' in sec:
                legacy['init_password.db_password'] = sec.get('DB_PASSWORD', '')
                legacy['init_password.db_password_confirm'] = sec.get('DB_PASSWORD', '')
            if 'DB_HOST_PORT' in sec:
                legacy['init_password.db_host_port'] = sec.get('DB_HOST_PORT', '5432')
        if cfg.has_section('Network'):
            sec = cfg['Network']
            if 'KDC_AUTO_DETECTED' in sec:
                legacy['kerberos_config.kdc'] = sec.get('KDC_AUTO_DETECTED', '')
            if 'KERBEROS_AUTO_ENABLED' in sec:
                legacy['kerberos_config.enabled'] = sec.get('KERBEROS_AUTO_ENABLED', '')
        if cfg.has_section('Kerberos Authentication'):
            sec = cfg['Kerberos Authentication']
            for k, tgt in (
                ('ENABLED', 'kerberos_config.enabled'),
                ('REALM', 'kerberos_config.realm'),
                ('KDC', 'kerberos_config.kdc'),
                ('USER', 'kerberos_config.user'),
                ('PASSWORD', 'kerberos_config.password'),
            ):
                if k in sec:
                    legacy[tgt] = sec.get(k, '')
        if cfg.has_section('Optional Features'):
            sec = cfg['Optional Features']
            if 'SUPABASE_ENABLED' in sec:
                legacy['init_cluster.supabase_enabled'] = sec.get('SUPABASE_ENABLED', '')
            if 'KERBEROS_ENABLED' in sec:
                legacy['init_cluster.kerberos_enabled'] = sec.get('KERBEROS_ENABLED', '')
                legacy['kerberos_config.enabled'] = sec.get('KERBEROS_ENABLED', '')
            if 'AT_REST_ENCRYPTION_ENABLED' in sec:
                legacy['init_cluster.at_rest_encryption_enabled'] = sec.get('AT_REST_ENCRYPTION_ENABLED', '')
        if cfg.has_section('Initialize Cluster'):
            sec = cfg['Initialize Cluster']
            if 'ENVIRONMENT' in sec:
                legacy['init_cluster.cluster_env'] = sec.get('ENVIRONMENT', '')
        if cfg.has_section('Database Creation'):
            sec = cfg['Database Creation']
            if 'DB_NAME' in sec:
                legacy['init_password.db_namespace'] = sec.get('DB_NAME', '')
                legacy['env_setup.NAMESPACE'] = sec.get('DB_NAME', '')
            if 'NAMESPACE' in sec:
                legacy['init_password.db_namespace'] = sec.get('NAMESPACE', '')
                legacy['env_setup.NAMESPACE'] = sec.get('NAMESPACE', '')
            if 'DB_USER' in sec:
                legacy['init_password.db_username'] = sec.get('DB_USER', '')
        mark_auto(legacy)
        return legacy

    def _default_inputs(self) -> dict:
        namespace = self._initial_namespace()
        owner = self._get_local_owner()
        env_vals = self._env_defaults(namespace)
        inputs: dict[str, str] = {}

        # Dependencies
        inputs['dependencies.verify_all'] = _bool_str(False)
        inputs['dependencies.auto_install_missing'] = _bool_str(DEFAULT_ACTION_FLAGS.get('dependencies.auto_install_missing', True))
        for dep in self.dependencies:
            inputs[f"dependencies.{dep['id']}.install"] = _bool_str(True)

        # Network scan
        inputs['network_scan.run'] = _bool_str(DEFAULT_ACTION_FLAGS.get('network_scan.run', True))

        # Environment setup
        for k in ('PROLE_HOME', 'PROLE_CONF', 'PROLE_DATA', 'PROLE_LOGS', 'PROLE_SERVICE'):
            inputs[f'env_setup.{k}'] = env_vals.get(k, '')
        inputs['env_setup.NAMESPACE'] = namespace

        # Database creation
        inputs['init_password.db_namespace'] = namespace
        inputs['init_password.db_username'] = owner
        inputs['init_password.db_password'] = ''
        inputs['init_password.db_password_confirm'] = ''
        inputs['init_password.generate_ssh_key'] = _bool_str(DEFAULT_ACTION_FLAGS.get('init_password.generate_ssh_key', True))

        # Build DB image
        inputs['init_db_build.run_build'] = _bool_str(DEFAULT_ACTION_FLAGS.get('init_db_build.run_build', True))

        # Cluster init + optional features
        inputs['init_cluster.cluster_env'] = 'dev'
        inputs['init_cluster.supabase_enabled'] = _bool_str(False)
        inputs['init_cluster.kerberos_enabled'] = _bool_str(False)
        inputs['init_cluster.at_rest_encryption_enabled'] = _bool_str(True)
        inputs['init_cluster.start_cluster'] = _bool_str(DEFAULT_ACTION_FLAGS.get('init_cluster.start_cluster', True))

        # Kerberos config
        inputs['kerberos_config.enabled'] = _bool_str(False)
        inputs['kerberos_config.realm'] = ''
        inputs['kerberos_config.kdc'] = ''
        inputs['kerberos_config.user'] = ''
        inputs['kerberos_config.password'] = ''
        inputs['kerberos_config.test_connection'] = _bool_str(DEFAULT_ACTION_FLAGS.get('kerberos_config.test_connection', False))
        inputs['kerberos_config.init_authority'] = _bool_str(DEFAULT_ACTION_FLAGS.get('kerberos_config.init_authority', False))

        # Init scripts + deploy
        inputs['init_scripts.run_scripts'] = _bool_str(DEFAULT_ACTION_FLAGS.get('init_scripts.run_scripts', True))
        inputs['init_cnpg_deploy.run_deploy'] = _bool_str(DEFAULT_ACTION_FLAGS.get('init_cnpg_deploy.run_deploy', True))
        inputs['init_cnpg_deploy.force_rollout'] = _bool_str(DEFAULT_ACTION_FLAGS.get('init_cnpg_deploy.force_rollout', False))

        # Disk selection (installer packaging)
        inputs['disk_selection.disk_type'] = 'local'
        inputs['disk_selection.removable_mount'] = ''
        inputs['disk_selection.local_path'] = str(Path.home())

        # Build tools app
        inputs['build.deploy_env'] = 'Dev'
        inputs['build.run_build'] = _bool_str(DEFAULT_ACTION_FLAGS.get('build.run_build', False))

        return inputs

    def _get_input(self, key: str, default: str | None = None) -> str:
        if key in self.inputs:
            return self.inputs[key]
        return default if default is not None else ''

    def _get_input_bool(self, key: str, default: bool = False) -> bool:
        return _parse_bool(self._get_input(key, None), default=default)

    # ---------------- Namespace helpers ----------------
    def _get_local_owner(self) -> str:
        try:
            return getpass.getuser()
        except Exception:
            try:
                return os.getlogin()
            except Exception:
                return "prole"

    def _sanitize_namespace(self, name: str) -> str:
        cleaned = re.sub(r'[^a-z0-9-]+', '-', (name or '').lower())
        cleaned = re.sub(r'-{2,}', '-', cleaned).strip('-')
        if not cleaned:
            cleaned = 'prole'
        if len(cleaned) > 63:
            cleaned = cleaned[:63].rstrip('-')
        return cleaned

    def _generate_namespace_name(self) -> str:
        owner = self._sanitize_namespace(self._get_local_owner())
        suffix = uuid.uuid4().hex[:6]
        base = f"prole-{owner}-{suffix}"
        return self._sanitize_namespace(base)

    def _ensure_namespace_prefix(self, name: str) -> str:
        cleaned = (name or '').strip()
        if not cleaned:
            return NAMESPACE_PREFIX
        if cleaned.startswith(NAMESPACE_PREFIX):
            return cleaned
        return f"{NAMESPACE_PREFIX}{cleaned}"

    def _initial_namespace(self) -> str:
        try:
            existing = self._read_existing_env()
            ns = existing.get('NAMESPACE') or existing.get('PROLE_NAMESPACE')
            if ns:
                return self._ensure_namespace_prefix(ns)
        except Exception:
            pass
        ns = os.environ.get('NAMESPACE') or os.environ.get('PROLE_NAMESPACE')
        if ns:
            return self._ensure_namespace_prefix(ns)
        return self._ensure_namespace_prefix(self._generate_namespace_name())

    def _is_valid_namespace(self, name: str) -> bool:
        if not name or len(name) > 63:
            return False
        return re.match(r'^[a-z0-9]([-a-z0-9]*[a-z0-9])?$', name) is not None

    # ---------------- Env helpers ----------------
    def _env_defaults(self, namespace: str | None = None) -> dict:
        home = Path.home() / '.prole'
        return {
            'PROLE_HOME': str(home),
            'PROLE_CONF': str(home / 'conf'),
            'PROLE_DATA': str(home / 'data'),
            'PROLE_LOGS': str(home / 'logs'),
            'PROLE_SERVICE': str(home / 'etc'),
            'NAMESPACE': namespace or '',
        }

    def _read_existing_env(self) -> dict:
        env = {}
        prole_home = os.environ.get('PROLE_HOME')
        candidates = []
        if prole_home:
            candidates.append(Path(prole_home).expanduser() / 'env.sh')
        candidates.append(Path.home() / '.prole' / 'env.sh')
        for p in candidates:
            try:
                if p.exists():
                    for line in p.read_text().splitlines():
                        line = line.strip()
                        if not line or line.startswith('#'):
                            continue
                        if line.startswith('export '):
                            line = line[len('export '):]
                        if '=' in line:
                            k, v = line.split('=', 1)
                            env[k.strip()] = v.strip().strip('"')
                    break
            except Exception:
                pass
        return env

    def _save_env_to_file(self, values: dict):
        home = Path(values['PROLE_HOME']).expanduser()
        home.mkdir(parents=True, exist_ok=True)
        for key in ('PROLE_CONF', 'PROLE_DATA', 'PROLE_LOGS', 'PROLE_SERVICE'):
            try:
                Path(values[key]).expanduser().mkdir(parents=True, exist_ok=True)
            except Exception:
                pass
        content = []
        content.append('#!/usr/bin/env bash')
        content.append('# Prole environment configuration')
        content.append('# This file is generated by the installer. Source it in new shells, or execute as a wrapper:')
        content.append('#   "$PROLE_HOME/env.sh" <command> [args…]')
        content.append('# shellcheck shell=bash')
        for k in ('PROLE_HOME', 'PROLE_CONF', 'PROLE_DATA', 'PROLE_LOGS', 'PROLE_SERVICE'):
            content.append(f'export {k}="{values[k]}"')
        if values.get('NAMESPACE'):
            content.append(f'export NAMESPACE="{values["NAMESPACE"]}"')
        content.append('')
        content.append('# Ensure PATH works for GUI-launched shells (Docker, etc.)')
        content.append('_prole_add_path() { case ":${PATH}:" in *":$1:"*) ;; *) PATH="$1:${PATH:-}" ;; esac; }')
        content.append('_prole_add_path "$PROLE_HOME/bin"')
        content.append('_prole_add_path "/opt/homebrew/bin"')
        content.append('_prole_add_path "/usr/local/bin"')
        content.append('_prole_add_path "/usr/bin"')
        content.append('_prole_add_path "/bin"')
        content.append('_prole_add_path "/usr/sbin"')
        content.append('_prole_add_path "/sbin"')
        content.append('export PATH')
        content.append('')
        content.append('# Add custom paths below if needed (examples):')
        content.append('')
        content.append('# If executed with arguments (and not sourced), run them under this environment')
        content.append('if [[ "${BASH_SOURCE[0]}" == "${0}" ]] && [ "$#" -gt 0 ]; then')
        content.append('  exec "$@"')
        content.append('fi')
        tmp = home / 'env.sh.tmp'
        out = home / 'env.sh'
        tmp.write_text('\n'.join(content) + '\n')
        tmp.replace(out)
        try:
            os.chmod(out, 0o755)
        except Exception:
            pass

        try:
            prole_home = Path(values['PROLE_HOME']).expanduser()
            prole_service = Path(values['PROLE_SERVICE']).expanduser()

            init_pf_src_candidates = [
                self.project_root / 'src' / 'prole' / 'etc' / 'init-port-forward.sh',
                self.project_root / 'etc' / 'init-port-forward.sh',
            ]
            init_pf_src = next((p for p in init_pf_src_candidates if p.exists()), None)
            if init_pf_src is not None:
                init_pf_dst = prole_home / 'init-port-forward.sh'
                try:
                    data = init_pf_src.read_bytes()
                    init_pf_dst.write_bytes(data)
                    os.chmod(init_pf_dst, 0o755)
                except Exception:
                    pass

            etc_src_candidates = [
                self.project_root / 'src' / 'prole' / 'etc',
                self.project_root / 'etc',
            ]
            etc_src = next((p for p in etc_src_candidates if p.exists()), None)
            if etc_src is not None:
                try:
                    prole_service.mkdir(parents=True, exist_ok=True)
                    if etc_src.resolve() != prole_service.resolve():
                        if prole_service.exists():
                            shutil.rmtree(prole_service, ignore_errors=True)
                        shutil.copytree(etc_src, prole_service)
                except Exception:
                    pass
        except Exception:
            pass

    def reload_env_from_shell(self) -> None:
        home = Path(self._get_input('env_setup.PROLE_HOME', str(Path.home() / '.prole')))
        env_file = home / 'env.sh'
        cmd = (
            f'export PROLE_HOME={shlex.quote(str(home))}; '
            f'source {shlex.quote(str(env_file))}; '
            'env -0'
        )
        try:
            out = subprocess.check_output(['bash', '-lc', cmd])
        except Exception as e:
            raise Exception(f"Failed to reload environment: {e}")
        try:
            for raw in out.split(b'\x00'):
                if not raw:
                    continue
                kv = raw.decode('utf-8', errors='ignore')
                if '=' not in kv:
                    continue
                k, v = kv.split('=', 1)
                if k in ('PYTHONPATH', 'PYTHONHOME'):
                    continue
                os.environ[k] = v
        except Exception:
            pass

    def _update_env_namespace(self, namespace: str):
        try:
            existing = self._read_existing_env()
            defaults = self._env_defaults(namespace)
            values = {**defaults, **existing}
            values['NAMESPACE'] = namespace
            self._save_env_to_file(values)
            os.environ['NAMESPACE'] = namespace
        except Exception as e:
            self.err(f"[WARN] Failed to update env.sh namespace: {e}")

    # ---------------- Process helpers ----------------
    def _run_cmd(self, cmd, cwd=None, env=None, stdin_text=None, on_stdout=None, on_stderr=None) -> int:
        stdin_handle = subprocess.PIPE if stdin_text else None
        if isinstance(cmd, str):
            proc = subprocess.Popen(['bash', '-lc', cmd], cwd=cwd, env=env, stdout=subprocess.PIPE, stderr=subprocess.PIPE, stdin=stdin_handle, text=True, bufsize=1)
        else:
            proc = subprocess.Popen(cmd, cwd=cwd, env=env, stdout=subprocess.PIPE, stderr=subprocess.PIPE, stdin=stdin_handle, text=True, bufsize=1)
        if stdin_text and proc.stdin:
            try:
                proc.stdin.write(stdin_text)
                proc.stdin.close()
            except Exception:
                pass

        def _read_stream(stream, handler, is_err=False):
            if not stream:
                return
            for line in iter(stream.readline, ''):
                if handler:
                    handler(line)
                else:
                    if is_err:
                        self.err(line.rstrip('\n'))
                    else:
                        self.log(line.rstrip('\n'))

        err_thread = threading.Thread(target=_read_stream, args=(proc.stderr, on_stderr, True), daemon=True)
        err_thread.start()
        _read_stream(proc.stdout, on_stdout, False)
        rc = proc.wait()
        err_thread.join(timeout=2)
        return rc

    def _run_script(self, script_name: str, args=None, env=None, stdin_text=None) -> int:
        def _stdout(line):
            self.log(line.rstrip('\n'))

        def _stderr(line):
            self.err(line.rstrip('\n'))

        return self.controller.run_script(
            script_name,
            args=args or [],
            env=env,
            stdin_text=stdin_text,
            on_line=_stdout,
            on_stderr_line=_stderr,
            stderr_to_stdout=False,
        )

    def _ensure_local_registry_available(self):
        """Ensure a local k3d registry is running and return (host_registry, cluster_registry)."""
        reg_name = 'prole-registry'
        registry_container = f'k3d-{reg_name}'
        host_registry = 'localhost:5000'
        cluster_registry = f'{registry_container}.localhost:5000'

        if not self.controller.check_docker_running():
            self.err("[WARN] Docker not running; cannot ensure local registry.")
            return None

        k3d_exists = subprocess.run(['which', 'k3d'], capture_output=True).returncode == 0
        if not k3d_exists:
            self.err("[WARN] k3d not found; cannot ensure local registry.")
            return None

        lst = subprocess.run(['k3d', 'registry', 'list'], capture_output=True, text=True)
        if registry_container not in (lst.stdout or '') and reg_name not in (lst.stdout or ''):
            self.log("[INFO] Creating local k3d registry...")
            subprocess.run(['k3d', 'registry', 'create', reg_name, '--port', '0.0.0.0:5000'], check=True)

        running = subprocess.run(
            ['docker', 'ps', '--filter', f'name={registry_container}', '--format', '{{.Names}}'],
            capture_output=True, text=True
        )
        if not (running.stdout or '').strip():
            exists = subprocess.run(
                ['docker', 'ps', '-a', '--filter', f'name={registry_container}', '--format', '{{.Names}}'],
                capture_output=True, text=True
            )
            if (exists.stdout or '').strip():
                subprocess.run(['docker', 'start', registry_container], check=True)

        self.local_registry_url = host_registry
        self.local_registry_internal = cluster_registry
        self.prole_cfg_data['Docker Build']['LOCAL_REGISTRY'] = host_registry
        self.prole_cfg_data['Docker Build']['LOCAL_REGISTRY_INTERNAL'] = cluster_registry
        return host_registry, cluster_registry

    def _collect_dependent_images(self, include_supabase: bool, include_kerberos_proxy: bool) -> list[str]:
        images = set()
        for rel_dir in ('k8s/prole', 'k8s/openbao'):
            base_dir = self.project_root / rel_dir
            if not base_dir.exists():
                continue
            images.update(_collect_images_from_files(list(base_dir.glob('*.yaml'))))

        if include_supabase:
            supa_home = _resolve_supabase_home(self.project_root)
            if supa_home:
                docker_dir = supa_home / 'docker'
                compose_files = [docker_dir / 'docker-compose.yml']
                if os.environ.get('SUPABASE_USE_DEV_COMPOSE') == '1':
                    compose_files.append(docker_dir / 'dev' / 'docker-compose.dev.yml')
                images.update(_collect_images_from_files(compose_files))

        if not include_supabase:
            images = {img for img in images if 'supabase' not in img}

        if include_kerberos_proxy:
            krb_img = os.environ.get('KRB5_AD_PROXY_IMAGE', 'alpine/socat')
            if krb_img:
                images.add(krb_img)

        return sorted(images)

    def _prepull_images_to_registry(self, include_supabase: bool, include_kerberos_proxy: bool) -> bool:
        info = self._ensure_local_registry_available()
        if not info:
            self.err("[WARN] Local registry unavailable; skipping image pre-pull.")
            return False

        registry, _cluster_registry = info
        images = self._collect_dependent_images(include_supabase, include_kerberos_proxy)
        if not images:
            self.log("[INFO] No dependent images found to pre-pull.")
            return True

        overall_ok = True
        for image in images:
            self.log(f"[INFO] Pulling {image}...")
            pull = subprocess.run(['docker', 'pull', image], capture_output=True, text=True)
            if pull.returncode != 0:
                overall_ok = False
                self.err(pull.stdout or '')
                self.err(pull.stderr or '')
                self.err(f"[ERROR] docker pull failed for {image}")
                continue

            local_tag = image
            if not image.startswith(f"{registry}/"):
                local_tag = f"{registry}/{image}"
                tag = subprocess.run(['docker', 'tag', image, local_tag], capture_output=True, text=True)
                if tag.returncode != 0:
                    overall_ok = False
                    self.err(tag.stdout or '')
                    self.err(tag.stderr or '')
                    self.err(f"[ERROR] docker tag failed for {image}")
                    continue

            push = subprocess.run(['docker', 'push', local_tag], capture_output=True, text=True)
            if push.returncode != 0:
                overall_ok = False
                self.err(push.stdout or '')
                self.err(push.stderr or '')
                self.err(f"[ERROR] docker push failed for {local_tag}")
                continue
            self.log(f"[OK] Stored {image} in local registry as {local_tag}")

        return overall_ok

    # ---------------- Steps ----------------
    def _apply_inputs(self):
        defaults = self._default_inputs()
        loaded = self._load_inputs_from_cfg()
        self.inputs = {**defaults, **loaded}
        try:
            self._apply_ansible_defaults(set(loaded.keys()))
        except Exception:
            pass

        for k in ('env_setup.PROLE_HOME', 'env_setup.PROLE_CONF', 'env_setup.PROLE_DATA', 'env_setup.PROLE_LOGS', 'env_setup.PROLE_SERVICE'):
            if k in self.inputs:
                self.inputs[k] = _expand_path(self.inputs[k])

    def _apply_ansible_defaults(self, loaded_keys: set[str] | None = None):
        info = _detect_ansible_topology(self.project_root)
        if not info:
            return
        loaded_keys = loaded_keys or set()
        auto_keys = getattr(self, '_auto_input_keys', set())
        ansible_kdc = info.get('kdc_ip') or ''
        try:
            net = self.prole_cfg_data.get('Network', {})
            if info.get('topology_json'):
                net['ANSIBLE_TOPOLOGY'] = info['topology_json']
            if info.get('inventory_path'):
                net['ANSIBLE_INVENTORY'] = info['inventory_path']
            if info.get('infrastructure_path'):
                net['ANSIBLE_INFRASTRUCTURE'] = info['infrastructure_path']
            if info.get('domain'):
                net['ANSIBLE_DOMAIN'] = info['domain']
            if info.get('realm'):
                net['ANSIBLE_REALM'] = info['realm']
            if info.get('ad_dc_host'):
                net['AD_DC_HOST'] = info['ad_dc_host']
            if info.get('ad_dc_ip'):
                net['AD_DC_IP'] = info['ad_dc_ip']
            if info.get('kdc_ip'):
                net['KDC_ANSIBLE_DETECTED'] = info['kdc_ip']
            self.prole_cfg_data['Network'] = net
        except Exception:
            pass

        if ansible_kdc and 'kerberos_config.kdc' in auto_keys:
            self.inputs['kerberos_config.kdc'] = ansible_kdc
        if ansible_kdc and 'kerberos_config.enabled' in auto_keys:
            self.inputs['kerberos_config.enabled'] = _bool_str(True)

        if 'kerberos_config.kdc' not in loaded_keys:
            if not self._get_input('kerberos_config.kdc', '').strip() and info.get('kdc_ip'):
                self.inputs['kerberos_config.kdc'] = info['kdc_ip']
        if 'kerberos_config.realm' not in loaded_keys:
            if not self._get_input('kerberos_config.realm', '').strip() and info.get('realm'):
                self.inputs['kerberos_config.realm'] = info['realm']
        if 'kerberos_config.enabled' not in loaded_keys:
            if info.get('kdc_ip') and not self._get_input_bool('kerberos_config.enabled', False):
                self.inputs['kerberos_config.enabled'] = _bool_str(True)

    def _write_cfg(self):
        globals_to_save = {
            'PROLE_HOME': self._get_input('env_setup.PROLE_HOME', ''),
            'PROLE_DB_USER': self._get_input('init_password.db_username', ''),
            'DB_PASSWORD': self._get_input('init_password.db_password', ''),
            'CLUSTER_ENV': self._get_input('init_cluster.cluster_env', ''),
            'NAMESPACE': (self._get_input('init_password.db_namespace', '') or '').strip(),
            'DB_HOST_PORT': (self._get_input('init_password.db_host_port', '5432') or '5432').strip(),
        }
        globals_to_save.update(self.prole_cfg_data.get('Global', {}))

        sections = {k: self.prole_cfg_data.get(k, {}) for k in [
            'Welcome', 'Dependencies', 'Network', 'System Environment',
            'Kerberos Authentication', 'Optional Features', 'Database Creation',
            'Initialize Cluster', 'Docker Build', 'Initialization Scripts',
            'Prole DB Deploy', 'Install'
        ]}
        cfg_text = _render_prole_cfg(self.inputs, globals_to_save, sections)
        self.cfg_path.parent.mkdir(parents=True, exist_ok=True)
        self.cfg_path.write_text(cfg_text)
        self.log(f"[CONFIG] Wrote {self.cfg_path}")

    def _step_dependencies(self) -> bool:
        self.log("==> Dependencies")
        missing = []
        for dep in self.dependencies:
            ok, location, version = inst_config.get_dep_info(dep)
            if ok:
                self.log(f"[OK] {dep['name']} {version or ''}".strip())
                continue
            missing.append(dep)
            self.log(f"[MISSING] {dep['name']}")

        if not missing:
            self.prole_cfg_data['Dependencies']['STATUS'] = 'All installed'
            return True

        auto_install = self._get_input_bool('dependencies.auto_install_missing', DEFAULT_ACTION_FLAGS.get('dependencies.auto_install_missing', True))
        if not auto_install:
            self.err("[ERROR] Dependencies missing and auto-install disabled.")
            self.prole_cfg_data['Dependencies']['STATUS'] = 'Missing'
            return False

        for dep in missing:
            install_cmd = dep.get('install_cmd')
            if not install_cmd:
                self.err(f"[ERROR] No install command for {dep['name']}.")
                continue
            should_install = self._get_input_bool(f"dependencies.{dep['id']}.install", True)
            if not should_install:
                self.err(f"[SKIP] {dep['name']} install disabled by config.")
                continue
            self.log(f"[INSTALL] {dep['name']} -> {install_cmd}")
            rc = self._run_cmd(install_cmd)
            if rc != 0:
                self.err(f"[ERROR] Install failed for {dep['name']} (code {rc})")

        still_missing = []
        for dep in missing:
            ok, _, _ = inst_config.get_dep_info(dep)
            if not ok:
                still_missing.append(dep['name'])
        if still_missing:
            self.err(f"[ERROR] Still missing: {', '.join(still_missing)}")
            self.prole_cfg_data['Dependencies']['STATUS'] = 'Missing'
            return False
        self.prole_cfg_data['Dependencies']['STATUS'] = 'All installed'
        return True

    def _step_network_scan(self) -> None:
        if not self._get_input_bool('network_scan.run', DEFAULT_ACTION_FLAGS.get('network_scan.run', True)):
            self.log("[SKIP] Network scan disabled.")
            return
        self.log("==> Network scan (prole-agent)")
        ansible_kdc = ''
        try:
            ansible_kdc = (self.prole_cfg_data.get('Network', {}) or {}).get('KDC_ANSIBLE_DETECTED', '')
        except Exception:
            ansible_kdc = ''
        scan_binary = get_resource_path("prole-net/prole-agent")
        if not scan_binary.exists():
            self.err(f"[ERROR] Scan binary not found at {scan_binary}")
            return

        prole_home = Path.home() / ".prole"
        scan_dir = prole_home / "scan"
        scan_dir.mkdir(parents=True, exist_ok=True)

        kdc_found = None

        def _handle_stdout(line: str):
            nonlocal kdc_found
            self.log(line.rstrip('\n'))
            if "KDC is:" in line:
                try:
                    ip_part = line.split("KDC is:")[1].strip()
                    ip = ip_part.split()[0].strip('[]():,')
                    if ip:
                        kdc_found = ip
                except Exception:
                    pass
            elif "Active Directory" in line or "88" in line:
                for part in line.split():
                    try:
                        socket.inet_aton(part.strip('[]():,'))
                        kdc_found = part.strip('[]():,')
                        break
                    except Exception:
                        continue

        rc = self._run_cmd([str(scan_binary), "-t", "10", "-s"], cwd=str(scan_dir), on_stdout=_handle_stdout)
        if rc == 0:
            self.log("[OK] Scan complete.")
        else:
            self.err(f"[ERROR] Scan failed (code {rc})")
        if kdc_found and not ansible_kdc:
            self.inputs['kerberos_config.kdc'] = kdc_found
            self.inputs['kerberos_config.enabled'] = _bool_str(True)
            self.prole_cfg_data['Network']['KDC_AUTO_DETECTED'] = kdc_found
            self.prole_cfg_data['Network']['KERBEROS_AUTO_ENABLED'] = 'True'
        elif kdc_found and ansible_kdc:
            self.log(f"[INFO] Ansible KDC detected ({ansible_kdc}); ignoring scan-detected KDC {kdc_found}.")

    def _step_env_setup(self) -> None:
        self.log("==> Environment setup")
        vals = {
            'PROLE_HOME': self._get_input('env_setup.PROLE_HOME', str(Path.home() / '.prole')),
            'PROLE_CONF': self._get_input('env_setup.PROLE_CONF', ''),
            'PROLE_DATA': self._get_input('env_setup.PROLE_DATA', ''),
            'PROLE_LOGS': self._get_input('env_setup.PROLE_LOGS', ''),
            'PROLE_SERVICE': self._get_input('env_setup.PROLE_SERVICE', ''),
        }
        defaults = self._env_defaults(self._get_input('env_setup.NAMESPACE', ''))
        for k in vals:
            if not vals[k]:
                vals[k] = defaults.get(k, '')
        vals['NAMESPACE'] = self._get_input('env_setup.NAMESPACE', '')

        if not vals.get('PROLE_HOME'):
            raise Exception("PROLE_HOME is required for env setup.")
        # Persist normalized inputs
        for k in ('PROLE_HOME', 'PROLE_CONF', 'PROLE_DATA', 'PROLE_LOGS', 'PROLE_SERVICE'):
            self.inputs[f'env_setup.{k}'] = vals[k]
        self.inputs['env_setup.NAMESPACE'] = vals.get('NAMESPACE', '')
        self._save_env_to_file(vals)
        self.reload_env_from_shell()

        for k in ('PROLE_HOME', 'PROLE_CONF', 'PROLE_DATA', 'PROLE_LOGS', 'PROLE_SERVICE'):
            self.prole_cfg_data['System Environment'][k] = vals[k]

    def _step_init_password(self) -> None:
        self.log("==> Database creation")
        ns = (self._get_input('init_password.db_namespace', '') or '').strip()
        if not ns:
            ns = self._get_input('env_setup.NAMESPACE', '')
        if not ns:
            raise Exception("Database namespace cannot be empty.")
        if not self._is_valid_namespace(ns):
            raise Exception("Invalid database namespace.")
        user = (self._get_input('init_password.db_username', '') or '').strip()
        if not user:
            raise Exception("Database owner cannot be empty.")
        p1 = self._get_input('init_password.db_password', '')
        p2 = self._get_input('init_password.db_password_confirm', '') or p1
        if not p1:
            raise Exception("Database password cannot be empty.")
        if p1 != p2:
            raise Exception("Database passwords do not match.")

        self.inputs['init_password.db_namespace'] = ns
        self.inputs['env_setup.NAMESPACE'] = ns
        self.inputs['init_password.db_password'] = p1
        self.inputs['init_password.db_password_confirm'] = p2
        self._update_env_namespace(ns)

        self.prole_cfg_data['Database Creation']['DB_USER'] = user
        self.prole_cfg_data['Database Creation']['DB_PASSWORD_SET'] = 'true'
        self.prole_cfg_data['Database Creation']['DB_NAME'] = ns
        self.prole_cfg_data['Database Creation']['NAMESPACE'] = ns

        include_supabase = self._get_input_bool('init_cluster.supabase_enabled', False)
        include_kerberos = self._get_input_bool('init_cluster.kerberos_enabled', False) or self._get_input_bool('kerberos_config.enabled', False)
        try:
            self._prepull_images_to_registry(include_supabase, include_kerberos)
        except Exception as e:
            self.err(f"[WARN] Image pre-pull error: {e}")

        if self._get_input_bool('init_password.generate_ssh_key', DEFAULT_ACTION_FLAGS.get('init_password.generate_ssh_key', True)):
            self._generate_ssh_key(user)

        # Initialize OpenBao and store keys/passwords for this namespace
        if not self.controller.check_docker_running():
            if platform.system() == 'Darwin':
                self.log("Starting Docker...")
                self._run_cmd(['open', '-a', 'Docker'])
            for _ in range(30):
                time.sleep(2)
                if self.controller.check_docker_running():
                    break
        if not self.controller.check_docker_running():
            raise Exception("Docker is not running; OpenBao requires Docker.")

        env = os.environ.copy()
        env["PROLE_HOME"] = str(self.project_root)
        env["PROLE_SERVICE"] = str(self.project_root)
        env["PROLE_DB_USER"] = user
        env["DB_PASSWORD"] = p1
        env["NAMESPACE"] = ns
        env["AT_REST_ENCRYPTION_ENABLED"] = _bool_str(self._get_input_bool('init_cluster.at_rest_encryption_enabled', False))
        realm = self._get_input('kerberos_config.realm', '').strip()
        kdc = self._get_input('kerberos_config.kdc', '').strip()
        krb_user = self._get_input('kerberos_config.user', '').strip()
        krb_pw = self._get_input('kerberos_config.password', '').strip()
        if realm:
            env["KRB5_REALM"] = realm
            env["REALM"] = realm
            env["DOMAIN"] = realm.lower()
        if kdc:
            env["KRB5_KDC"] = kdc
            env["KRB5_ADMIN"] = kdc
        if krb_user:
            env["KRB5_USER"] = krb_user
        if krb_pw:
            env["KRB5_PASSWORD"] = krb_pw
        self.log("==> OpenBao initialize")
        rc_bao = self._run_script("init_openbao.sh", args=["initialize"], env=env, stdin_text=f"{p1}\n")
        if rc_bao != 0:
            raise Exception(f"OpenBao initialization failed (code {rc_bao})")

    def _generate_ssh_key(self, user: str):
        self.log("==> Environment Preparation (Secure Access)")
        key_path = Path.home() / ".ssh" / "id_prole_ed25519"
        key_path.parent.mkdir(parents=True, exist_ok=True)
        if key_path.exists():
            self.log(f"[SKIP] Secure access keys already exist at {key_path}")
            return
        cmd = ["ssh-keygen", "-t", "ed25519", "-N", "", "-f", str(key_path), "-C", user]
        rc = self._run_cmd(cmd)
        if rc != 0:
            self.err(f"[WARN] Preparation failed (code {rc}), trying alternative.")
            cmd = ["ssh-keygen", "-t", "rsa", "-b", "4096", "-N", "", "-f", str(key_path), "-C", user]
            rc = self._run_cmd(cmd)
        if rc != 0:
            self.err(f"[ERROR] Preparation failed (code {rc})")

    def _step_db_build(self) -> None:
        if not self._get_input_bool('init_db_build.run_build', DEFAULT_ACTION_FLAGS.get('init_db_build.run_build', True)):
            self.log("[SKIP] DB build disabled.")
            self.prole_cfg_data['Docker Build']['STATUS'] = 'Skipped'
            return
        self.log("==> Build prole-db image")
        tag = self.controller.get_prole_db_version()
        image_name = f"prole-db:{tag}"
        prole_home = Path.home() / ".prole"
        build_dir = prole_home / "build" / "prole-db"
        build_dir.mkdir(parents=True, exist_ok=True)
        source_dir = get_resource_path("prole-db")
        if source_dir.exists():
            if source_dir.resolve() != build_dir.resolve():
                if build_dir.exists():
                    shutil.rmtree(build_dir)
                shutil.copytree(source_dir, build_dir)

        pub_key_path = Path.home() / ".ssh" / "id_prole_ed25519.pub"
        pub_key = pub_key_path.read_text().strip() if pub_key_path.exists() else ""
        username = self._get_input('init_password.db_username', '')

        cmd = [
            'docker', 'build',
            '--build-arg', f"PROLE_USER={username}",
            '--build-arg', f"PROLE_SSH_PUB_KEY={pub_key}",
            '-t', image_name, '.'
        ]
        rc = self._run_cmd(cmd, cwd=str(build_dir))
        if rc == 0:
            self._db_built_success = True
            self.log("[OK] Build successful.")
            cluster_name = f"prole-{self._get_input('init_cluster.cluster_env', 'dev')}-cluster"
            self.log(f"Importing image to {cluster_name}...")
            self._run_cmd(['k3d', 'image', 'import', image_name, '-c', cluster_name])
            self.prole_cfg_data['Docker Build']['STATUS'] = 'Built'
        else:
            self._db_built_success = False
            self.err(f"[ERROR] Build failed (code {rc})")
            self.prole_cfg_data['Docker Build']['STATUS'] = 'Attempted'

    def _step_cluster(self) -> None:
        self.log("==> Cluster setup")
        cluster_env = self._get_input('init_cluster.cluster_env', 'dev')
        self.prole_cfg_data['Initialize Cluster']['ENVIRONMENT'] = cluster_env
        self.prole_cfg_data['Optional Features']['SUPABASE_ENABLED'] = _bool_str(self._get_input_bool('init_cluster.supabase_enabled', False))
        self.prole_cfg_data['Optional Features']['KERBEROS_ENABLED'] = _bool_str(self._get_input_bool('init_cluster.kerberos_enabled', False))
        self.prole_cfg_data['Optional Features']['AT_REST_ENCRYPTION_ENABLED'] = _bool_str(self._get_input_bool('init_cluster.at_rest_encryption_enabled', False))

        if not self._get_input_bool('init_cluster.start_cluster', DEFAULT_ACTION_FLAGS.get('init_cluster.start_cluster', True)):
            self.log("[SKIP] Cluster start disabled.")
            return

        if not self.controller.check_docker_running():
            if platform.system() == 'Darwin':
                self.log("Starting Docker...")
                self._run_cmd(['open', '-a', 'Docker'])
            for _ in range(30):
                time.sleep(2)
                if self.controller.check_docker_running():
                    break
        if not self.controller.check_docker_running():
            raise Exception("Docker is not running.")

        # Ensure OpenBao container is running (local-only)
        env = os.environ.copy()
        env["PROLE_HOME"] = str(self.project_root)
        env["PROLE_SERVICE"] = str(self.project_root)
        env["NAMESPACE"] = (self._get_input('init_password.db_namespace', '') or '').strip()
        env["AT_REST_ENCRYPTION_ENABLED"] = _bool_str(self._get_input_bool('init_cluster.at_rest_encryption_enabled', False))
        rc_bao = self._run_script("init_openbao.sh", args=["start"], env=env)
        if rc_bao != 0:
            raise Exception(f"OpenBao start failed (code {rc_bao})")

        # Ensure local registry is available before cluster creation (dev only)
        if cluster_env == 'dev':
            if not self._ensure_local_registry_available():
                raise Exception("Local registry is not running.")

        cluster_name = f"prole-{cluster_env}-cluster"
        res = subprocess.run(['k3d', 'cluster', 'list', '--no-headers'], capture_output=True, text=True)
        if cluster_name not in res.stdout:
            cmd = ['k3d', 'cluster', 'create', cluster_name, '-a', '2']
            if cluster_env == 'service':
                cmd += ['--registry-create', 'k8s-prole-org-registry:k8s.prole.org:5000', '--api-port', '10.0.0.205:6443']
            elif cluster_env == 'dev':
                reg_args = []
                try:
                    if self._ensure_local_registry_available():
                        reg_args = ['--registry-use', 'k3d-prole-registry:5000']
                except Exception:
                    reg_args = []
                cmd += reg_args + ['--api-port', '0.0.0.0:6443']
            self._run_cmd(cmd)
        else:
            self._run_cmd(['k3d', 'cluster', 'start', cluster_name])
        self.log(f"[OK] Cluster ready: {cluster_name}")

    def _step_kerberos(self) -> None:
        enabled = self._get_input_bool('kerberos_config.enabled', self.kerberos_enabled.get())
        if not enabled:
            self.log("[SKIP] Kerberos disabled.")
            return
        realm = self._get_input('kerberos_config.realm', '')
        kdc = self._get_input('kerberos_config.kdc', '')
        user = self._get_input('kerberos_config.user', '')
        password = self._get_input('kerberos_config.password', '')
        self.prole_cfg_data['Kerberos Authentication']['ENABLED'] = _bool_str(enabled)
        self.prole_cfg_data['Kerberos Authentication']['REALM'] = realm
        self.prole_cfg_data['Kerberos Authentication']['KDC'] = kdc
        self.prole_cfg_data['Kerberos Authentication']['SERVER'] = kdc
        self.prole_cfg_data['Kerberos Authentication']['USER'] = user
        self.prole_cfg_data['Kerberos Authentication']['PASSWORD'] = password
        self.prole_cfg_data['Kerberos Authentication']['AD_PORT_FORWARD'] = os.environ.get('KRB5_AD_PORT_FORWARD', '1')
        self.prole_cfg_data['Kerberos Authentication']['AD_TCP_PORTS'] = os.environ.get('KRB5_AD_TCP_PORTS', '88 389 445 464 636')
        self.prole_cfg_data['Kerberos Authentication']['AD_UDP_PORTS'] = os.environ.get('KRB5_AD_UDP_PORTS', '88 464')
        self.prole_cfg_data['Kerberos Authentication']['AD_PROXY_HOST_NETWORK'] = os.environ.get('KRB5_AD_PROXY_HOST_NETWORK', '1')
        self.prole_cfg_data['Kerberos Authentication']['AD_PROXY_IMAGE'] = os.environ.get('KRB5_AD_PROXY_IMAGE', 'alpine/socat')
        self.prole_cfg_data['Kerberos Authentication']['AD_PROXY_SERVICE'] = os.environ.get('KRB5_AD_SERVICE_NAME', 'prole-kerberos-ad-dc')

        env = os.environ.copy()
        env["PROLE_HOME"] = str(self.project_root)
        env["PROLE_SERVICE"] = str(self.project_root)
        env["NAMESPACE"] = (self._get_input('init_password.db_namespace', '') or '').strip()
        env["KRB5_REALM"] = realm
        env["REALM"] = realm
        env["DOMAIN"] = realm.lower()
        env["KRB5_KDC"] = kdc
        env["KRB5_ADMIN"] = kdc
        env["KRB5_USER"] = user
        env["KRB5_PASSWORD"] = password
        env.setdefault("KRB5_AD_PORT_FORWARD", "1")

        if self._get_input_bool('kerberos_config.init_authority', False):
            self.log("==> Kerberos authority: init_authority.sh start")
            rc_auth_bao = self._run_script("init_openbao.sh", args=["start"], env=env)
            if rc_auth_bao != 0:
                self.err(f"[ERROR] OpenBao start failed (code {rc_auth_bao})")
            else:
                rc_auth = self._run_script("init_authority.sh", args=["start"], env=env)
                if rc_auth != 0:
                    self.err(f"[ERROR] Authority initialization failed (code {rc_auth})")
                else:
                    self.log("[OK] Authority initialization completed successfully.")

        if not self._get_input_bool('kerberos_config.test_connection', DEFAULT_ACTION_FLAGS.get('kerberos_config.test_connection', False)):
            self.log("[SKIP] Kerberos test disabled.")
            return
        if not (realm and user and password and kdc):
            self.err("[WARN] Kerberos test skipped: missing realm/user/password/kdc.")
            return

        self.log("==> Kerberos test: init_kerberos.sh test")
        rc2 = self._run_script("init_kerberos.sh", args=["test"], env=env)
        if rc2 != 0:
            self.err(f"[ERROR] Kerberos test failed (code {rc2})")
        else:
            self.log("[OK] Kerberos test completed successfully.")

    def _step_init_scripts(self) -> None:
        if not self._get_input_bool('init_scripts.run_scripts', DEFAULT_ACTION_FLAGS.get('init_scripts.run_scripts', True)):
            self.log("[SKIP] Init scripts disabled.")
            self.prole_cfg_data['Initialization Scripts']['STATUS'] = 'Skipped'
            return
        self.log("==> Initialization scripts")
        password = self._get_input('init_password.db_password', '')

        env = os.environ.copy()
        env["PROLE_HOME"] = str(self.project_root)
        env["PROLE_SERVICE"] = str(self.project_root)
        env["PROLE_DB_USER"] = self._get_input('init_password.db_username', '')
        env["DB_PASSWORD"] = password
        env["NAMESPACE"] = (self._get_input('init_password.db_namespace', '') or '').strip()
        realm = self._get_input('kerberos_config.realm', '').strip()
        kdc = self._get_input('kerberos_config.kdc', '').strip()
        user = self._get_input('kerberos_config.user', '').strip()
        krb_pw = self._get_input('kerberos_config.password', '').strip()
        if realm:
            env["KRB5_REALM"] = realm
            env["REALM"] = realm
            env["DOMAIN"] = realm.lower()
        if kdc:
            env["KRB5_KDC"] = kdc
            env["KRB5_ADMIN"] = kdc
        if user:
            env["KRB5_USER"] = user
        if krb_pw:
            env["KRB5_PASSWORD"] = krb_pw
        env.setdefault("KRB5_AD_PORT_FORWARD", "1")

        self.log("Stopping existing port-forwards to avoid conflicts...")
        self._run_script("init_port_forwards.sh", args=["stop"], env=env)

        steps = [
            ("init_garage_store.sh", ["start"], False),
            ("init_cloudnative_pg.sh", ["initialize"], False),
        ]
        if self._get_input_bool('kerberos_config.enabled', False):
            steps.append(("init_kerberos.sh", ["initialize"], False))
        steps.extend([
            ("init_prole-db.sh", ["start"], False),
            ("init_prole-db-backup.sh", ["start"], False),
            ("init_monitoring.sh", ["initialize"], False),
            ("init_port_forwards.sh", ["start"], False),
        ])

        overall_success = True
        for script, args, needs_password in steps:
            self.log(f"--> {script} {' '.join(args)}")
            stdin_text = f"{password}\n" if needs_password else None
            
            # Use custom line handler for monitoring to capture Grafana password
            on_line = None
            if script == "init_monitoring.sh":
                def _mon_stdout(line):
                    if "GRAFANA_ADMIN_PASSWORD=" in line:
                        pwd = line.split("GRAFANA_ADMIN_PASSWORD=")[1].strip()
                        if pwd:
                            self.prole_cfg_data['Monitoring'] = {'GRAFANA_ADMIN_PASSWORD': pwd}
                            self._write_cfg()
                on_line = _mon_stdout

            rc = self._run_script(script, args=args, env=env, stdin_text=stdin_text)
            if rc != 0:
                self.err(f"[ERROR] {script} failed (code {rc})")
                overall_success = False
        self._scripts_success = overall_success
        self.prole_cfg_data['Initialization Scripts']['STATUS'] = 'Completed' if overall_success else 'Attempted'

    def _step_cnpg_deploy(self) -> None:
        if not self._get_input_bool('init_cnpg_deploy.run_deploy', DEFAULT_ACTION_FLAGS.get('init_cnpg_deploy.run_deploy', True)):
            self.log("[SKIP] CnPG deploy disabled.")
            self.prole_cfg_data['Prole DB Deploy']['STATUS'] = 'Skipped'
            return
        self.log("==> Deploy CloudNative-PG")
        etc_dir = self.project_root / "etc"
        env = os.environ.copy()
        env["PROLE_HOME"] = str(self.project_root)
        env["PROLE_SERVICE"] = str(self.project_root)
        env["NAMESPACE"] = (self._get_input('init_password.db_namespace', '') or '').strip()
        rc = self._run_cmd(['bash', str(etc_dir / 'init_prole-db.sh'), 'deploy', 'latest'], env=env)
        if rc == 0:
            self._cnpg_success = True
            self.prole_cfg_data['Prole DB Deploy']['STATUS'] = 'Deployed'
        else:
            self._cnpg_success = False
            self.prole_cfg_data['Prole DB Deploy']['STATUS'] = 'Attempted'
            self.err(f"[ERROR] CnPG deploy failed (code {rc})")

        if self._get_input_bool('init_cnpg_deploy.force_rollout', DEFAULT_ACTION_FLAGS.get('init_cnpg_deploy.force_rollout', False)):
            self.log("==> Force rollout")
            rc2 = self._run_cmd(['bash', str(etc_dir / 'init_prole-db.sh'), 'rollout'], env=env)
            if rc2 != 0:
                self.err(f"[ERROR] Rollout failed (code {rc2})")

    def _step_supabase(self) -> None:
        if not self._get_input_bool('supabase_config.run_deploy', self.supabase_enabled.get()):
            self.log("[SKIP] Supabase deploy disabled.")
            self.prole_cfg_data['Supabase'] = {'STATUS': 'Skipped'}
            return
        self.log("==> Deploy Supabase")
        env = os.environ.copy()
        env["PROLE_HOME"] = str(self.project_root)
        env["PROLE_SERVICE"] = str(self.project_root)
        env["NAMESPACE"] = (self._get_input('init_password.db_namespace', '') or '').strip()
        rc = self._run_script('supabase.sh', env=env)
        if rc == 0:
            self._supabase_success = True
            self.prole_cfg_data['Supabase'] = {'STATUS': 'Deployed'}
        else:
            self._supabase_success = False
            self.prole_cfg_data['Supabase'] = {'STATUS': 'Attempted'}
            self.err(f"[ERROR] Supabase deploy failed (code {rc})")

    def run(self) -> int:
        _configure_unbuffered_io()
        self.log(f"[CONFIG] Using {self.cfg_path}")
        try:
            self._apply_inputs()
        except Exception as e:
            self.err(f"[FATAL] {e}")
            return 2

        self._write_cfg()

        try:
            if not self._step_dependencies():
                self._write_cfg()
                return 1
            self._write_cfg()

            self._step_network_scan()
            self._write_cfg()

            self._step_env_setup()
            self._write_cfg()

            self._step_init_password()
            self._write_cfg()

            self._step_cluster()
            self._write_cfg()

            self._step_db_build()
            self._write_cfg()

            self._step_init_scripts()
            self._write_cfg()

            self._step_kerberos()
            self._write_cfg()

            self._step_supabase()
            self._write_cfg()

            self._step_cnpg_deploy()
            self._write_cfg()

            self.prole_cfg_data['Install']['STATUS'] = 'Finished'
            self._write_cfg()
            self.log("[DONE] Silent install completed.")
            return 0
        except Exception as e:
            self.err(f"[FATAL] {e}")
            try:
                self.prole_cfg_data['Install']['STATUS'] = 'Failed'
                self._write_cfg()
            except Exception:
                pass
            return 2


def has_display():
    """Check if a display is available for GUI."""
    # Check DISPLAY environment variable (X11)
    if os.environ.get('DISPLAY'):
        return True

    # On macOS, check if running in graphical session
    if platform.system() == 'Darwin':
        try:
            # Try to create a Tk root to see if GUI is available
            test_root = tk.Tk()
            test_root.withdraw()
            test_root.destroy()
            return True
        except Exception:
            return False

    # On Linux/Unix, no DISPLAY means no GUI
    return False


def main():
    import argparse

    # Parse command-line arguments
    parser = argparse.ArgumentParser(description='Prole Database Installer')
    parser.add_argument('-c', '--config', default=None,
                        help='Path to prole.cfg for saving or silent replay')
    parser.add_argument('-S', '--silent', action='store_true',
                        help='Run unattended install in console mode using prole.cfg')
    parser.add_argument('--no-gui', action='store_true',
                        help='Run installer with ncurses terminal interface instead of GUI')
    parser.add_argument('--gui', action='store_true',
                        help='Force GUI mode (will fail if no display available)')
    args = parser.parse_args()

    # Create controller (shared business logic)
    controller = ProleController(PROJECT_ROOT)

    # Silent console mode (unattended)
    if args.silent:
        installer = ProleSilentInstaller(controller, args.config)
        sys.exit(installer.run())

    # Determine which interface to use
    use_gui = False
    if args.gui:
        # Force GUI mode
        use_gui = True
    elif args.no_gui:
        # Force ncurses mode
        use_gui = False
    else:
        # Auto-detect: use GUI if display is available, otherwise ncurses
        use_gui = has_display()

    if use_gui:
        # Run Tk GUI interface
        try:
            root = tk.Tk()
            root.title("Prole Database Installer")
            # Center window similarly to legacy UI
            window_width, window_height = 1000, 700
            try:
                sw, sh = root.winfo_screenwidth(), root.winfo_screenheight()
                cx, cy = int(sw / 2 - window_width / 2), int(sh / 2 - window_height / 2)
                root.geometry(f"{window_width}x{window_height}+{cx}+{cy}")
            except Exception:
                root.geometry(f"{window_width}x{window_height}")

            ProleInstaller(root, config_path=args.config)

            # Launch the main installer window immediately with background and welcome page.
            # The lightweight dependency verification runs on the welcome page and gates the footer there.
            root.mainloop()
        except Exception as e:
            print(f"Failed to start GUI: {e}", file=sys.stderr)
            print("Falling back to ncurses interface...", file=sys.stderr)
            time.sleep(1)
            from installer.ncurses_installer import run_ncurses_installer
            run_ncurses_installer(controller)
    else:
        # Run ncurses interface
        from installer.ncurses_installer import run_ncurses_installer
        run_ncurses_installer(controller)


if __name__ == '__main__':
    main()