thanh-kit 2.5.0 → 2.5.2

package/templates/skills/install.sh

@@ -50,17 +50,99 @@ declare -a FAILED_OPTIONAL=()
 declare -a SKIPPED_SUDO=()
 FINAL_EXIT_CODE=0
 
-# Detect OS
+# Detect OS (including WSL and Windows shells)
 detect_os() {
     if [[ "$OSTYPE" == "darwin"* ]]; then
         echo "macos"
-    elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
-        echo "linux"
+    elif [[ "$OSTYPE" == "linux-gnu"* ]] || [[ "$OSTYPE" == "linux"* ]]; then
+        # Check for WSL
+        if [[ -f /proc/version ]] && grep -qi microsoft /proc/version 2>/dev/null; then
+            echo "wsl"
+        else
+            echo "linux"
+        fi
+    elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "mingw"* ]]; then
+        echo "msys"  # Git Bash / MSYS2
+    elif [[ "$OSTYPE" == "cygwin" ]]; then
+        echo "cygwin"
+    else
+        echo "unknown"
+    fi
+}
+
+# Detect Linux distribution (for package manager selection)
+detect_distro() {
+    # WSL uses the underlying Linux distro
+    if [[ "$OS" != "linux" ]] && [[ "$OS" != "wsl" ]]; then
+        echo "none"
+        return
+    fi
+
+    # Alpine detection (check first - most specific)
+    if [[ -f /etc/alpine-release ]]; then
+        echo "alpine"
+    # Arch Linux detection
+    elif [[ -f /etc/arch-release ]] || command_exists pacman; then
+        echo "arch"
+    # Debian/Ubuntu detection
+    elif command_exists apt-get; then
+        echo "debian"
+    # RHEL/CentOS/Fedora detection
+    elif command_exists dnf; then
+        echo "redhat"
+    elif command_exists yum; then
+        echo "redhat"
     else
         echo "unknown"
     fi
 }
 
+# Package manager abstraction - update package lists
+pkg_update() {
+    case "$DISTRO" in
+        alpine)
+            apk update
+            ;;
+        arch)
+            pacman -Sy
+            ;;
+        debian)
+            apt-get update -qq
+            ;;
+        redhat)
+            dnf check-update || true
+            ;;
+        *)
+            print_warning "Unknown distro, skipping package update"
+            ;;
+    esac
+}
+
+# Package manager abstraction - install package
+# Usage: pkg_install <package_name>
+pkg_install() {
+    local package_name="$1"
+
+    case "$DISTRO" in
+        alpine)
+            apk add --no-cache "$package_name"
+            ;;
+        arch)
+            pacman -S --noconfirm "$package_name"
+            ;;
+        debian)
+            apt-get install -y "$package_name"
+            ;;
+        redhat)
+            dnf install -y "$package_name"
+            ;;
+        *)
+            print_warning "Unknown distro, cannot install $package_name"
+            return 1
+            ;;
+    esac
+}
+
 # Print functions (must be defined before check_bash_version)
 print_header() {
     echo -e "\n${BLUE}===================================================${NC}"
@@ -116,6 +198,9 @@ command_exists() {
     command -v "$1" >/dev/null 2>&1
 }
 
+# Initialize distro detection (after command_exists is defined)
+DISTRO=$(detect_distro)
+
 # ============================================================================
 # Installation Tracking Functions
 # ============================================================================
@@ -245,8 +330,24 @@ try_pip_install() {
     # Phase 2: Check if we can build from source
     if ! has_build_tools; then
         print_warning "$package_name: No wheel available, no build tools"
-        if [[ "$OS" == "linux" ]]; then
-            print_info "Install build tools: sudo apt-get install gcc python3-dev"
+        if [[ "$OS" == "linux" ]] || [[ "$OS" == "wsl" ]]; then
+            case "$DISTRO" in
+                alpine)
+                    print_info "Install build tools: apk add build-base python3-dev"
+                    ;;
+                arch)
+                    print_info "Install build tools: sudo pacman -S base-devel python"
+                    ;;
+                debian)
+                    print_info "Install build tools: sudo apt-get install gcc python3-dev"
+                    ;;
+                redhat)
+                    print_info "Install build tools: sudo dnf install gcc python3-devel"
+                    ;;
+                *)
+                    print_info "Install build tools: gcc and python3-dev equivalent"
+                    ;;
+            esac
         elif [[ "$OS" == "macos" ]]; then
             print_info "Install build tools: xcode-select --install"
         fi
@@ -295,17 +396,39 @@ install_system_package() {
         fi
     fi
 
-    # Linux: only install if --with-sudo was passed
-    if [[ "$WITH_SUDO" == "true" ]]; then
-        print_info "Installing $display_name (sudo)..."
-        if sudo apt-get install -y "$package_name"; then
-            print_success "$display_name installed"
-            track_success "optional" "$display_name"
-            return 0
+    # Linux: only install if --with-sudo was passed (except Alpine which often runs as root)
+    if [[ "$WITH_SUDO" == "true" ]] || [[ "$DISTRO" == "alpine" && "$(id -u)" == "0" ]]; then
+        print_info "Installing $display_name..."
+        if [[ "$WITH_SUDO" == "true" ]]; then
+            # Call package manager directly with sudo (functions don't work with sudo)
+            local install_result=0
+            case "$DISTRO" in
+                alpine) sudo apk add --no-cache "$package_name" || install_result=1 ;;
+                arch) sudo pacman -S --noconfirm "$package_name" || install_result=1 ;;
+                debian) sudo apt-get install -y "$package_name" || install_result=1 ;;
+                redhat) sudo dnf install -y "$package_name" || install_result=1 ;;
+                *) install_result=1 ;;
+            esac
+            if [[ "$install_result" -eq 0 ]]; then
+                print_success "$display_name installed"
+                track_success "optional" "$display_name"
+                return 0
+            else
+                print_warning "$display_name: package install failed"
+                track_failure "optional" "$display_name" "package install failed"
+                return 1
+            fi
         else
-            print_warning "$display_name: apt-get install failed"
-            track_failure "optional" "$display_name" "apt-get install failed"
-            return 1
+            # Alpine as root (no sudo needed)
+            if pkg_install "$package_name"; then
+                print_success "$display_name installed"
+                track_success "optional" "$display_name"
+                return 0
+            else
+                print_warning "$display_name: package install failed"
+                track_failure "optional" "$display_name" "package install failed"
+                return 1
+            fi
         fi
     else
         # No sudo permission - track as skipped
@@ -325,16 +448,33 @@ check_package_manager() {
         else
             print_success "Homebrew found"
         fi
-    elif [[ "$OS" == "linux" ]]; then
-        if command_exists apt-get; then
-            print_success "apt-get found"
-        elif command_exists yum; then
-            print_success "yum found"
-        else
-            print_warning "No supported package manager found (apt-get or yum)"
-            print_info "System packages will be skipped"
-            # Don't exit - just warn and continue
-        fi
+    elif [[ "$OS" == "linux" ]] || [[ "$OS" == "wsl" ]]; then
+        case "$DISTRO" in
+            alpine)
+                print_success "apk found (Alpine Linux)"
+                ;;
+            arch)
+                print_success "pacman found (Arch Linux)"
+                ;;
+            debian)
+                print_success "apt-get found (Debian/Ubuntu)"
+                ;;
+            redhat)
+                if command_exists dnf; then
+                    print_success "dnf found (RHEL/Fedora)"
+                else
+                    print_success "yum found (RHEL/CentOS)"
+                fi
+                ;;
+            *)
+                print_warning "No supported package manager found (apk, pacman, apt-get, dnf, or yum)"
+                print_info "System packages will be skipped"
+                ;;
+        esac
+    elif [[ "$OS" == "msys" ]] || [[ "$OS" == "cygwin" ]]; then
+        print_warning "Windows shell detected ($OS)"
+        print_info "System package installation not supported"
+        print_info "Please install dependencies manually or use WSL"
     fi
 }
 
@@ -342,10 +482,22 @@ check_package_manager() {
 install_system_deps() {
     print_header "Installing System Dependencies"
 
-    # Update apt cache if we have sudo permission (Linux only)
-    if [[ "$OS" == "linux" ]] && [[ "$WITH_SUDO" == "true" ]]; then
-        print_info "Updating package lists..."
-        sudo apt-get update -qq
+    # Update package cache if we have permission (Linux only)
+    if [[ "$OS" == "linux" ]]; then
+        if [[ "$WITH_SUDO" == "true" ]]; then
+            print_info "Updating package lists..."
+            # Call package manager directly with sudo (functions don't work with sudo)
+            case "$DISTRO" in
+                alpine) sudo apk update ;;
+                arch) sudo pacman -Sy ;;
+                debian) sudo apt-get update -qq ;;
+                redhat) sudo dnf check-update || true ;;
+            esac
+        elif [[ "$DISTRO" == "alpine" && "$(id -u)" == "0" ]]; then
+            # Alpine as root (no sudo needed)
+            print_info "Updating package lists..."
+            pkg_update
+        fi
     fi
 
     # FFmpeg (required for media-processing skill)
@@ -377,9 +529,57 @@ install_node_deps() {
         print_info "Installing Node.js..."
         if [[ "$OS" == "macos" ]]; then
             brew install node
-        elif [[ "$OS" == "linux" ]]; then
-            curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
-            sudo apt-get install -y nodejs
+        elif [[ "$OS" == "linux" ]] || [[ "$OS" == "wsl" ]]; then
+            case "$DISTRO" in
+                alpine)
+                    # Alpine: install via apk
+                    if [[ "$(id -u)" == "0" ]]; then
+                        apk add --no-cache nodejs npm
+                    elif [[ "$WITH_SUDO" == "true" ]]; then
+                        sudo apk add --no-cache nodejs npm
+                    else
+                        print_warning "Node.js installation requires root or --with-sudo"
+                        print_info "Run: apk add nodejs npm"
+                        return 1
+                    fi
+                    ;;
+                arch)
+                    # Arch: install via pacman
+                    if [[ "$(id -u)" == "0" ]]; then
+                        pacman -S --noconfirm nodejs npm
+                    elif [[ "$WITH_SUDO" == "true" ]]; then
+                        sudo pacman -S --noconfirm nodejs npm
+                    else
+                        print_warning "Node.js installation requires root or --with-sudo"
+                        print_info "Run: sudo pacman -S nodejs npm"
+                        return 1
+                    fi
+                    ;;
+                debian)
+                    # Debian/Ubuntu: use nodesource
+                    curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+                    sudo apt-get install -y nodejs
+                    ;;
+                redhat)
+                    # RHEL/CentOS/Fedora: use nodesource
+                    curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
+                    if command_exists dnf; then
+                        sudo dnf install -y nodejs
+                    else
+                        sudo yum install -y nodejs
+                    fi
+                    ;;
+                *)
+                    print_warning "Unknown distro, cannot install Node.js automatically"
+                    print_info "Please install Node.js manually"
+                    return 1
+                    ;;
+            esac
+        elif [[ "$OS" == "msys" ]] || [[ "$OS" == "cygwin" ]]; then
+            print_warning "Cannot install Node.js in $OS environment"
+            print_info "Please install Node.js from https://nodejs.org"
+            print_info "Or use WSL for better compatibility"
+            return 1
         fi
         print_success "Node.js installed"
     fi
@@ -488,19 +688,9 @@ setup_python_env() {
         PYTHON_PATH=$(which python3)
         print_success "Python3 found ($PYTHON_VERSION)"
 
-        # Check for broken UV Python installation
+        # Detect UV-managed Python — warn but don't exit (create_venv handles fallback)
         if [[ "$PYTHON_PATH" == *"/.local/share/uv/"* ]]; then
-            # Verify UV Python works by testing venv creation
-            if ! python3 -c "import sys; sys.exit(0 if '/install' not in sys.base_prefix else 1)" 2>/dev/null; then
-                print_error "UV Python installation is broken (corrupted sys.base_prefix)"
-                print_info "Please reinstall Python using Homebrew:"
-                print_info "  brew install python@3.12"
-                print_info "  export PATH=\"/opt/homebrew/bin:\$PATH\""
-                print_info "Or fix UV Python:"
-                print_info "  uv python uninstall 3.12"
-                print_info "  uv python install 3.12"
-                exit 1
-            fi
+            print_info "UV-managed Python detected (venv creation will use uv if needed)"
         fi
     else
         print_error "Python3 not found. Please install Python 3.7+"
@@ -514,9 +704,32 @@ setup_python_env() {
             return 0
         fi
 
+        # Try uv venv if available (handles uv-managed Python where python3 -m venv breaks)
+        if command_exists uv; then
+            print_warning "Standard venv creation failed, trying uv venv..."
+            if uv venv "$VENV_DIR" 2>/dev/null; then
+                # uv venv doesn't include pip — bootstrap it
+                if ! curl -sS https://bootstrap.pypa.io/get-pip.py | "$VENV_DIR/bin/python3" 2>/dev/null; then
+                    print_warning "Could not bootstrap pip via get-pip.py, trying uv pip..."
+                    if ! uv pip install pip --python "$VENV_DIR/bin/python3" 2>/dev/null; then
+                        print_error "Failed to install pip in uv venv"
+                        rm -rf "$VENV_DIR"
+                        return 1
+                    fi
+                fi
+                return 0
+            fi
+        fi
+
         # If ensurepip fails (common on macOS), create without pip and bootstrap manually
         print_warning "Standard venv creation failed, trying without ensurepip..."
-        if python3 -m venv --without-pip "$VENV_DIR"; then
+        if python3 -m venv --without-pip "$VENV_DIR" 2>/dev/null; then
+            # Verify the venv Python works (uv-managed Python may create broken venvs)
+            if ! "$VENV_DIR/bin/python3" -c "import sys" 2>/dev/null; then
+                print_warning "Venv Python is broken (cannot import stdlib), skipping..."
+                rm -rf "$VENV_DIR"
+                return 1
+            fi
             # Bootstrap pip manually with error handling
             source "$VENV_DIR/bin/activate"
             if ! curl -sS https://bootstrap.pypa.io/get-pip.py | python3; then
@@ -777,27 +990,87 @@ generate_remediation_commands() {
     echo ""
 
     if [[ "$has_sudo_skipped" == "true" ]]; then
-        echo "# System packages (requires sudo):"
-        echo "sudo apt-get update"
-        for item in "${SKIPPED_SUDO[@]}"; do
-            local pkg="${item%%:*}"
-            case "$pkg" in
-                FFmpeg) echo "sudo apt-get install -y ffmpeg" ;;
-                ImageMagick) echo "sudo apt-get install -y imagemagick" ;;
-                *) echo "# $pkg: see documentation" ;;
-            esac
-        done
+        echo "# System packages (requires root/sudo):"
+        case "$DISTRO" in
+            alpine)
+                echo "apk update"
+                for item in "${SKIPPED_SUDO[@]}"; do
+                    local pkg="${item%%:*}"
+                    case "$pkg" in
+                        FFmpeg) echo "apk add ffmpeg" ;;
+                        ImageMagick) echo "apk add imagemagick" ;;
+                        *) echo "# $pkg: see documentation" ;;
+                    esac
+                done
+                ;;
+            arch)
+                echo "sudo pacman -Sy"
+                for item in "${SKIPPED_SUDO[@]}"; do
+                    local pkg="${item%%:*}"
+                    case "$pkg" in
+                        FFmpeg) echo "sudo pacman -S --noconfirm ffmpeg" ;;
+                        ImageMagick) echo "sudo pacman -S --noconfirm imagemagick" ;;
+                        *) echo "# $pkg: see documentation" ;;
+                    esac
+                done
+                ;;
+            debian)
+                echo "sudo apt-get update"
+                for item in "${SKIPPED_SUDO[@]}"; do
+                    local pkg="${item%%:*}"
+                    case "$pkg" in
+                        FFmpeg) echo "sudo apt-get install -y ffmpeg" ;;
+                        ImageMagick) echo "sudo apt-get install -y imagemagick" ;;
+                        *) echo "# $pkg: see documentation" ;;
+                    esac
+                done
+                ;;
+            redhat)
+                echo "sudo dnf check-update"
+                for item in "${SKIPPED_SUDO[@]}"; do
+                    local pkg="${item%%:*}"
+                    case "$pkg" in
+                        FFmpeg) echo "sudo dnf install -y ffmpeg" ;;
+                        ImageMagick) echo "sudo dnf install -y ImageMagick" ;;
+                        *) echo "# $pkg: see documentation" ;;
+                    esac
+                done
+                ;;
+            *)
+                echo "# Unknown distro - install packages manually"
+                for item in "${SKIPPED_SUDO[@]}"; do
+                    local pkg="${item%%:*}"
+                    echo "# $pkg: see documentation"
+                done
+                ;;
+        esac
         echo ""
     fi
 
     if [[ "$has_python_failed" == "true" ]]; then
         echo "# Python packages (may require build tools):"
-        if [[ "$OS" == "linux" ]]; then
-            echo "sudo apt-get install -y gcc python3-dev libjpeg-dev zlib1g-dev"
-        elif [[ "$OS" == "macos" ]]; then
-            echo "xcode-select --install"
-            echo "brew install jpeg libpng"
-        fi
+        case "$DISTRO" in
+            alpine)
+                echo "apk add build-base python3-dev jpeg-dev zlib-dev"
+                ;;
+            arch)
+                echo "sudo pacman -S --noconfirm base-devel python libjpeg-turbo zlib"
+                ;;
+            debian)
+                echo "sudo apt-get install -y gcc python3-dev libjpeg-dev zlib1g-dev"
+                ;;
+            redhat)
+                echo "sudo dnf install -y gcc python3-devel libjpeg-devel zlib-devel"
+                ;;
+            *)
+                if [[ "$OS" == "macos" ]]; then
+                    echo "xcode-select --install"
+                    echo "brew install jpeg libpng"
+                else
+                    echo "# Install gcc, python3-dev, and image libraries for your distro"
+                fi
+                ;;
+        esac
         echo "source $VENV_DIR/bin/activate"
 
         for item in "${FAILED_OPTIONAL[@]}"; do
@@ -916,16 +1189,47 @@ write_error_summary() {
         skipped_json+="]"
     fi
 
+    # Generate distro-specific remediation commands
+    local sudo_pkg_cmd build_tools_cmd
+    case "$DISTRO" in
+        alpine)
+            sudo_pkg_cmd="apk add ffmpeg imagemagick"
+            build_tools_cmd="apk add build-base python3-dev jpeg-dev zlib-dev"
+            ;;
+        arch)
+            sudo_pkg_cmd="sudo pacman -S --noconfirm ffmpeg imagemagick"
+            build_tools_cmd="sudo pacman -S --noconfirm base-devel python libjpeg-turbo zlib"
+            ;;
+        debian)
+            sudo_pkg_cmd="sudo apt-get install -y ffmpeg imagemagick"
+            build_tools_cmd="sudo apt-get install -y gcc python3-dev libjpeg-dev zlib1g-dev"
+            ;;
+        redhat)
+            sudo_pkg_cmd="sudo dnf install -y ffmpeg ImageMagick"
+            build_tools_cmd="sudo dnf install -y gcc python3-devel libjpeg-devel zlib-devel"
+            ;;
+        *)
+            if [[ "$OS" == "macos" ]]; then
+                sudo_pkg_cmd="brew install ffmpeg imagemagick"
+                build_tools_cmd="xcode-select --install && brew install jpeg libpng"
+            else
+                sudo_pkg_cmd="# Install ffmpeg and imagemagick for your distro"
+                build_tools_cmd="# Install gcc, python3-dev, and image libraries for your distro"
+            fi
+            ;;
+    esac
+
     cat > "$summary_file" << EOF
 {
   "exit_code": $FINAL_EXIT_CODE,
   "timestamp": "$(date -Iseconds 2>/dev/null || date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "distro": "$DISTRO",
   "critical_failures": $critical_json,
   "optional_failures": $optional_json,
   "skipped": $skipped_json,
   "remediation": {
-    "sudo_packages": "sudo apt-get install -y ffmpeg imagemagick",
-    "build_tools": "sudo apt-get install -y gcc python3-dev libjpeg-dev zlib1g-dev",
+    "sudo_packages": "$sudo_pkg_cmd",
+    "build_tools": "$build_tools_cmd",
     "pip_retry": "source $VENV_DIR/bin/activate && pip install <package>"
   }
 }
@@ -949,6 +1253,12 @@ main() {
     echo ""  # Just add spacing, don't clear terminal
     print_header "Claude Code Skills Installation"
     print_info "OS: $OS"
+    if [[ "$OS" == "linux" ]] || [[ "$OS" == "wsl" ]]; then
+        print_info "Distro: $DISTRO"
+    fi
+    if [[ "$OS" == "wsl" ]]; then
+        print_info "Environment: Windows Subsystem for Linux"
+    fi
     print_info "Script directory: $SCRIPT_DIR"
     if [[ "$WITH_SUDO" == "true" ]]; then
         print_info "Mode: with sudo (--with-sudo)"
@@ -960,11 +1270,21 @@ main() {
     fi
     echo ""
 
+    # Handle unsupported OS
     if [[ "$OS" == "unknown" ]]; then
         print_error "Unsupported operating system"
         exit 1
     fi
 
+    # Warn about limited Windows shell support
+    if [[ "$OS" == "msys" ]] || [[ "$OS" == "cygwin" ]]; then
+        print_warning "Running in Windows shell environment ($OS)"
+        print_warning "Limited functionality - system packages cannot be installed"
+        print_info "For full support, consider using WSL (Windows Subsystem for Linux)"
+        print_info "Continuing with Python environment setup only..."
+        echo ""
+    fi
+
     # Confirm installation (skip if --yes flag or NON_INTERACTIVE env is set)
     if [[ "$SKIP_CONFIRM" == "false" ]]; then
         read -p "This will install system packages and Node.js dependencies. Continue? (y/N) " -n 1 -r

package/templates/{commands/journal.md → skills/journal/SKILL.md}

@@ -1,7 +1,11 @@
 ---
-description: ⚡ Write some journal entries.
+name: ck:journal
+description: "Write journal entries analyzing recent changes and session reflections."
+argument-hint: "[topic or reflection]"
 ---
 
+# Journal
+
 Use the `journal-writer` subagent to explore the memories and recent code changes, and write some journal entries.
 Journal entries should be concise and focused on the most important events, key changes, impacts, and decisions.
 Keep journal entries in the `./docs/journals/` directory.

package/templates/skills/kanban/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: ck:kanban
+description: "AI agent orchestration board for task visualization and team coordination."
+argument-hint: "[dir]"
+---
+
+# Plans Dashboard
+
+Plans dashboard with progress tracking and timeline visualization.
+
+## Usage
+
+- `/ck:kanban` - View dashboard for ./plans directory
+- `/ck:kanban <dir>` - View dashboard for specific directory
+- `/ck:kanban --stop` - Stop running server
+
+## Features
+
+- Plan cards with progress bars
+- Phase status breakdown (completed, in-progress, pending)
+- Timeline/Gantt visualization
+- Activity heatmap
+- Issue and branch links
+
+## Execution
+
+**IMPORTANT:** Run server as Claude Code background task using `run_in_background: true` with the Bash tool. This makes the server visible in `/tasks` and manageable via `KillShell`.
+
+The skill is located at `.claude/skills/plans-kanban/`.
+
+### Stop Server
+
+If `--stop` flag is provided:
+
+```bash
+node .claude/skills/plans-kanban/scripts/server.cjs --stop
+```
+
+### Start Server
+
+Otherwise, run the kanban server as CC background task with `--foreground` flag (keeps process alive for CC task management):
+
+```bash
+# Determine plans directory
+INPUT_DIR="$1"
+PLANS_DIR="${INPUT_DIR:-./plans}"
+
+# Start kanban dashboard
+node .claude/skills/plans-kanban/scripts/server.cjs \
+  --dir "$PLANS_DIR" \
+  --host 0.0.0.0 \
+  --open \
+  --foreground
+```
+
+**Critical:** When calling the Bash tool:
+- Set `run_in_background: true` to run as CC background task
+- Set `timeout: 300000` (5 minutes) to prevent premature termination
+- Parse JSON output and report URL to user
+
+Example Bash tool call:
+```json
+{
+  "command": "node .claude/skills/plans-kanban/scripts/server.cjs --dir \"./plans\" --host 0.0.0.0 --open --foreground",
+  "run_in_background": true,
+  "timeout": 300000,
+  "description": "Start kanban server in background"
+}
+```
+
+After starting, parse the JSON output and report:
+- Local URL for browser access
+- Network URL for remote device access (if available)
+- Inform user that server is now running as CC background task (visible in `/tasks`)
+
+**CRITICAL:** MUST display the FULL URL including path and query string. NEVER truncate to just `host:port`.
+
+## Future Plans
+
+The `/ck:kanban` command will evolve into **VibeKanban-inspired** AI agent orchestration:
+
+### Phase 1 (Current - MVP)
+- Task board with progress tracking
+- Visual representation of plans/tasks
+- Click to view plan details
+
+### Phase 2 (Worktree Integration)
+- Create tasks → spawn git worktrees
+- Assign agents to tasks
+- Track agent progress per worktree
+
+### Phase 3 (Full Orchestration)
+- Parallel agent execution monitoring
+- Code diff/review interface
+- PR creation workflow
+- Agent output streaming
+- Conflict detection
+
+Track progress: https://github.com/claudekit/claudekit-engineer/issues/189