juno-code 1.0.12 → 1.0.14

package/dist/templates/scripts/bootstrap.sh

@@ -0,0 +1,189 @@
+#!/usr/bin/env bash
+
+# bootstrap.sh
+#
+# Purpose: Pre-flight Python environment setup for juno-code
+#
+# This script runs before the main juno-code entrypoint and ensures:
+# 1. Python virtual environment (.venv_juno) exists
+# 2. Required Python packages are installed
+# 3. Virtual environment is activated if needed
+# 4. Main application can run with proper Python dependencies
+#
+# Usage: ./bootstrap.sh [main-entrypoint-command] [args...]
+#
+# Created by: juno-code init command
+# Date: Auto-generated during project initialization
+
+set -euo pipefail  # Exit on error, undefined variable, or pipe failure
+
+# DEBUG OUTPUT: Show that bootstrap.sh is being executed
+# User feedback: "Add a one line printing from .sh file as well so we could debug it"
+echo "[DEBUG] bootstrap.sh is being executed from: $(pwd)" >&2
+
+# Color output for better readability
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+VENV_DIR=".venv_juno"
+SCRIPTS_DIR=".juno_task/scripts"
+INSTALL_SCRIPT="${SCRIPTS_DIR}/install_requirements.sh"
+
+# Logging functions
+log_info() {
+    echo -e "${BLUE}[BOOTSTRAP]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[BOOTSTRAP]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[BOOTSTRAP]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[BOOTSTRAP]${NC} $1"
+}
+
+# Function to check if we're inside .venv_juno specifically
+# CRITICAL FIX: Don't just check for ANY venv - check if we're in .venv_juno
+# User feedback: "bootstrap.sh has the issues that install_requirements.sh used to have.
+# the detection of virtual enviroment is not correct."
+# Previous approach was too permissive - accepted ANY venv (conda, other venvs)
+# NEW APPROACH: Only return success if we're in .venv_juno specifically
+is_in_venv_juno() {
+    # Check if VIRTUAL_ENV is set and points to .venv_juno
+    if [ -n "${VIRTUAL_ENV:-}" ]; then
+        # Check if VIRTUAL_ENV path contains .venv_juno
+        if [[ "${VIRTUAL_ENV:-}" == *"/.venv_juno" ]] || [[ "${VIRTUAL_ENV:-}" == *".venv_juno"* ]]; then
+            return 0  # Inside .venv_juno
+        fi
+
+        # Check if the basename is .venv_juno
+        if [ "$(basename "${VIRTUAL_ENV:-}")" = ".venv_juno" ]; then
+            return 0  # Inside .venv_juno
+        fi
+    fi
+
+    return 1  # Not inside .venv_juno (or not in any venv)
+}
+
+# Function to activate virtual environment
+activate_venv() {
+    local venv_path="$1"
+
+    if [ ! -d "$venv_path" ]; then
+        log_error "Virtual environment not found: $venv_path"
+        return 1
+    fi
+
+    # Activate the venv
+    # shellcheck disable=SC1091
+    if [ -f "$venv_path/bin/activate" ]; then
+        source "$venv_path/bin/activate"
+        log_success "Activated virtual environment: $venv_path"
+        return 0
+    else
+        log_error "Activation script not found: $venv_path/bin/activate"
+        return 1
+    fi
+}
+
+# Function to ensure Python environment is ready
+ensure_python_environment() {
+    log_info "Checking Python environment..."
+
+    # CRITICAL FIX: Check if we're specifically in .venv_juno, not just ANY venv
+    # User feedback: "the detection of virtual enviroment is not correct"
+    # Previous logic accepted ANY venv (conda, other venvs) which was wrong
+    # NEW LOGIC: Only accept .venv_juno specifically
+
+    # Step 1: Check if we're already in .venv_juno specifically
+    if is_in_venv_juno; then
+        log_success "Already inside .venv_juno virtual environment"
+        return 0
+    fi
+
+    # Step 2: Not in .venv_juno - check if .venv_juno exists in project root
+    if [ -d "$VENV_DIR" ]; then
+        log_info "Found existing virtual environment: $VENV_DIR"
+
+        # Activate the venv
+        if activate_venv "$VENV_DIR"; then
+            return 0
+        else
+            log_error "Failed to activate virtual environment"
+            return 1
+        fi
+    fi
+
+    # Step 3: .venv_juno doesn't exist - need to create it
+    log_warning "Virtual environment not found: $VENV_DIR"
+    log_info "Running install_requirements.sh to create virtual environment..."
+
+    # Check if install_requirements.sh exists
+    if [ ! -f "$INSTALL_SCRIPT" ]; then
+        log_error "Install script not found: $INSTALL_SCRIPT"
+        log_error "Please run 'juno-code init' to initialize the project"
+        return 1
+    fi
+
+    # Make sure the script is executable
+    chmod +x "$INSTALL_SCRIPT"
+
+    # Run the install script
+    if bash "$INSTALL_SCRIPT"; then
+        log_success "Python environment setup completed successfully"
+
+        # After install, activate the venv if it was created
+        if [ -d "$VENV_DIR" ]; then
+            if activate_venv "$VENV_DIR"; then
+                return 0
+            fi
+        fi
+
+        return 0
+    else
+        log_error "Failed to run install_requirements.sh"
+        log_error "Please check the error messages above"
+        return 1
+    fi
+}
+
+# Main bootstrap logic
+main() {
+    log_info "=== juno-code Bootstrap ==="
+    echo ""
+
+    # Ensure Python environment is ready
+    if ! ensure_python_environment; then
+        log_error "Failed to setup Python environment"
+        exit 1
+    fi
+
+    echo ""
+    log_success "Python environment ready!"
+
+    # If there are additional arguments, execute them as the main entrypoint
+    if [ $# -gt 0 ]; then
+        log_info "Executing main entrypoint: $*"
+        echo ""
+
+        # Execute the main entrypoint with all arguments
+        exec "$@"
+    else
+        log_info "No main entrypoint specified - environment is ready for use"
+        log_info "To activate the virtual environment manually, run:"
+        echo ""
+        echo "    source $VENV_DIR/bin/activate"
+        echo ""
+    fi
+}
+
+# Run main function with all arguments
+main "$@"

package/dist/templates/scripts/clean_logs_folder.sh

@@ -11,7 +11,7 @@
 #
 # Usage: ./clean_logs_folder.sh
 #
-# Created by: juno-task-ts init command
+# Created by: juno-code init command
 # Date: Auto-generated during project initialization
 
 set -euo pipefail  # Exit on error, undefined variable, or pipe failure

package/dist/templates/scripts/install_requirements.sh

@@ -2,25 +2,32 @@
 
 # install_requirements.sh
 #
-# Purpose: Install Python dependencies required for juno-task-ts
+# Purpose: Install Python dependencies required for juno-code
 #
 # This script:
-# 1. Checks if 'uv' (ultrafast Python package manager) is installed
-# 2. Falls back to 'pip' if 'uv' is not available
-# 3. Detects virtual environment and installs accordingly:
+# 1. Checks if 'pipx' (recommended for app installations) is installed
+# 2. Falls back to 'uv' (ultrafast Python package manager) if 'pipx' not available
+# 3. Falls back to 'pip' if neither 'pipx' nor 'uv' is available
+# 4. Detects externally managed Python (PEP 668) on Ubuntu/Debian systems
+# 5. Handles installation based on environment:
 #    - If inside venv: installs into venv
-#    - If outside venv: uses --system flag for system-wide installation
-# 4. Installs required packages: juno-kanban, roundtable-ai
-# 5. Reports if requirements are already satisfied
-# 6. Shows error if neither 'uv' nor 'pip' is available
+#    - If externally managed Python detected: uses pipx or creates temporary venv
+#    - If outside venv (non-managed): uses --system flag for system-wide installation
+# 6. Installs required packages: juno-kanban, roundtable-ai
+# 7. Reports if requirements are already satisfied
 #
 # Usage: ./install_requirements.sh
 #
-# Created by: juno-task-ts init command
+# Created by: juno-code init command
 # Date: Auto-generated during project initialization
 
 set -euo pipefail  # Exit on error, undefined variable, or pipe failure
 
+# DEBUG OUTPUT: Show that install_requirements.sh is being executed
+# User feedback: "Add a one line printing from .sh file as well so we could debug it"
+echo "[DEBUG] install_requirements.sh is being executed from: $(pwd)" >&2
+echo "[DEBUG] .venv_juno will be created in: $(pwd)/.venv_juno" >&2
+
 # Color output for better readability
 RED='\033[0;31m'
 GREEN='\033[0;32m'
@@ -100,17 +107,168 @@ is_in_virtualenv() {
     return 1  # Not inside venv
 }
 
-# Function to install packages using uv
+# Function to find the best Python version (3.10-3.13, preferably 3.13)
+find_best_python() {
+    # Try to find Python in order of preference: 3.13, 3.12, 3.11, 3.10
+    local python_versions=("python3.13" "python3.12" "python3.11" "python3.10")
+
+    for py_cmd in "${python_versions[@]}"; do
+        if command -v "$py_cmd" &> /dev/null; then
+            # Verify it's actually the right version
+            local version
+            version=$($py_cmd --version 2>&1 | grep -oE '[0-9]+\.[0-9]+' | head -1)
+            local major
+            major=$(echo "$version" | cut -d'.' -f1)
+            local minor
+            minor=$(echo "$version" | cut -d'.' -f2)
+
+            # Check if version is 3.10 or higher
+            if [ "$major" -eq 3 ] && [ "$minor" -ge 10 ]; then
+                echo "$py_cmd"
+                return 0
+            fi
+        fi
+    done
+
+    # Fall back to python3 if available and check its version
+    if command -v python3 &> /dev/null; then
+        local version
+        version=$(python3 --version 2>&1 | grep -oE '[0-9]+\.[0-9]+' | head -1)
+        local major
+        major=$(echo "$version" | cut -d'.' -f1)
+        local minor
+        minor=$(echo "$version" | cut -d'.' -f2)
+
+        # Check if version is 3.10 or higher
+        if [ "$major" -eq 3 ] && [ "$minor" -ge 10 ]; then
+            echo "python3"
+            return 0
+        else
+            # Python3 exists but is too old
+            log_error "Found Python $version, but Python 3.10+ is required"
+            return 1
+        fi
+    fi
+
+    # No suitable Python found
+    log_error "No Python 3.10+ found. Please install Python 3.10, 3.11, 3.12, or 3.13 (preferably 3.13)"
+    return 1
+}
+
+# Function to check if Python is externally managed (PEP 668)
+# This is common on Ubuntu 23.04+, Debian, and other modern Linux distros
+is_externally_managed_python() {
+    # Check for EXTERNALLY-MANAGED marker file
+    local python_cmd="python3"
+    if ! command -v python3 &> /dev/null; then
+        if command -v python &> /dev/null; then
+            python_cmd="python"
+        else
+            return 1  # Python not found, can't determine
+        fi
+    fi
+
+    # Get the stdlib directory and check for EXTERNALLY-MANAGED file
+    local stdlib_dir
+    stdlib_dir=$($python_cmd -c "import sysconfig; print(sysconfig.get_path('stdlib'))" 2>/dev/null || echo "")
+
+    if [ -n "$stdlib_dir" ] && [ -f "$stdlib_dir/EXTERNALLY-MANAGED" ]; then
+        return 0  # Externally managed
+    fi
+
+    return 1  # Not externally managed
+}
+
+# Function to install packages using pipx
+install_with_pipx() {
+    log_info "Installing packages using 'pipx' (recommended for Python applications)..."
+
+    local failed_packages=()
+
+    for package in "${REQUIRED_PACKAGES[@]}"; do
+        log_info "Installing: $package"
+        if pipx install "$package" --force &>/dev/null || pipx install "$package" &>/dev/null; then
+            log_success "Successfully installed: $package"
+        else
+            log_error "Failed to install: $package"
+            failed_packages+=("$package")
+        fi
+    done
+
+    if [ ${#failed_packages[@]} -gt 0 ]; then
+        log_error "Failed to install ${#failed_packages[@]} package(s): ${failed_packages[*]}"
+        return 1
+    fi
+
+    return 0
+}
+
+# Function to install packages using uv with externally managed Python handling
 install_with_uv() {
     log_info "Installing packages using 'uv' (ultrafast Python package manager)..."
 
-    # Determine if we need --system flag
     local uv_flags="--quiet"
-    if ! is_in_virtualenv; then
-        log_info "Not in a virtual environment - using --system flag for system-wide installation"
-        uv_flags="--quiet --system"
-    else
-        log_info "Detected virtual environment - installing into venv"
+
+    # CRITICAL FIX: Properly detect if uv will work in the current environment
+    # User feedback: "Maybe the way you are verifying being inside venv by uv is not correct !!!"
+    # Previous approach failed because uv pip list doesn't reliably indicate venv compatibility
+    # NEW APPROACH: Always create .venv_juno unless we're already inside it
+
+    local venv_path=".venv_juno"
+    local need_venv=true
+
+    # Check if we're already inside .venv_juno
+    if [ -n "${VIRTUAL_ENV:-}" ] && ( [[ "${VIRTUAL_ENV:-}" == *"/.venv_juno" ]] || [[ "${VIRTUAL_ENV:-}" == *".venv_juno"* ]] ); then
+        log_info "Already inside .venv_juno virtual environment"
+        need_venv=false
+    # Check if we're in .venv_juno by checking the activate script path
+    elif [ -n "${VIRTUAL_ENV:-}" ] && [ "$(basename "${VIRTUAL_ENV:-}")" = ".venv_juno" ]; then
+        log_info "Already inside .venv_juno virtual environment"
+        need_venv=false
+    fi
+
+    # If we need a venv, create and activate .venv_juno
+    if [ "$need_venv" = true ]; then
+        log_info "Creating/using .venv_juno virtual environment for reliable uv installation..."
+
+        # Find best Python version (3.10-3.13, preferably 3.13)
+        local python_cmd
+        if ! python_cmd=$(find_best_python); then
+            log_error "Cannot create venv: No suitable Python version found"
+            log_info "Please install Python 3.10+ (preferably Python 3.13)"
+            log_info "  Mac: brew install python@3.13"
+            log_info "  Ubuntu/Debian: sudo apt install python3.13 python3.13-venv"
+            return 1
+        fi
+
+        local version
+        version=$($python_cmd --version 2>&1 | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')
+        log_info "Using Python $version for virtual environment"
+
+        # Create a project-local venv if it doesn't exist
+        if [ ! -d "$venv_path" ]; then
+            log_info "Creating virtual environment with $python_cmd..."
+            if ! $python_cmd -m venv "$venv_path" 2>/dev/null; then
+                log_error "Failed to create virtual environment"
+                log_info "Please ensure python venv module is installed:"
+                log_info "  Mac: brew install python@3.13"
+                log_info "  Ubuntu/Debian: sudo apt install python3.13-venv python3-full"
+                return 1
+            fi
+            log_success "Created virtual environment at $venv_path with Python $version"
+        else
+            log_info "Using existing virtual environment at $venv_path"
+        fi
+
+        # Activate the venv for this script
+        # shellcheck disable=SC1091
+        if [ -f "$venv_path/bin/activate" ]; then
+            source "$venv_path/bin/activate"
+            log_success "Activated virtual environment - uv will now install into .venv_juno"
+        else
+            log_error "Virtual environment activation script not found"
+            return 1
+        fi
     fi
 
     local failed_packages=()
@@ -133,7 +291,7 @@ install_with_uv() {
     return 0
 }
 
-# Function to install packages using pip
+# Function to install packages using pip with externally managed Python handling
 install_with_pip() {
     log_info "Installing packages using 'pip'..."
 
@@ -148,6 +306,41 @@ install_with_pip() {
         fi
     fi
 
+    # Handle externally managed Python or missing venv
+    if ! is_in_virtualenv && is_externally_managed_python; then
+        log_warning "Detected externally managed Python (PEP 668) - Ubuntu/Debian system"
+        log_info "Creating virtual environment for installation..."
+
+        # Find best Python version (3.10-3.13, preferably 3.13)
+        if ! python_cmd=$(find_best_python); then
+            log_error "Cannot create venv: No suitable Python version found"
+            log_info "Please install Python 3.10+ (preferably Python 3.13)"
+            log_info "  Ubuntu/Debian: sudo apt install python3.13 python3.13-venv"
+            return 1
+        fi
+
+        local version
+        version=$($python_cmd --version 2>&1 | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')
+        log_info "Using Python $version for virtual environment"
+
+        # Create a project-local venv if it doesn't exist
+        local venv_path=".venv_juno"
+        if [ ! -d "$venv_path" ]; then
+            if ! $python_cmd -m venv "$venv_path" 2>/dev/null; then
+                log_error "Failed to create virtual environment"
+                log_info "Please install python3-venv (Linux: sudo apt install python3.13-venv python3-full)"
+                return 1
+            fi
+            log_success "Created virtual environment at $venv_path with Python $version"
+        fi
+
+        # Activate the venv for this script
+        # shellcheck disable=SC1091
+        source "$venv_path/bin/activate"
+        log_success "Activated virtual environment"
+        python_cmd="python"  # Use the venv's python
+    fi
+
     local failed_packages=()
 
     for package in "${REQUIRED_PACKAGES[@]}"; do
@@ -194,28 +387,50 @@ main() {
     # Step 2: Determine which package manager to use
     local installer=""
 
-    if command -v uv &> /dev/null; then
+    # Check if Python is externally managed (Ubuntu/Debian PEP 668)
+    local is_ext_managed=false
+    if is_externally_managed_python && ! is_in_virtualenv; then
+        is_ext_managed=true
+        log_warning "Detected externally managed Python environment (Ubuntu/Debian PEP 668)"
+    fi
+
+    # Prioritize pipx for externally managed systems
+    if [ "$is_ext_managed" = true ] && command -v pipx &> /dev/null; then
+        log_success "'pipx' found - using pipx (recommended for externally managed Python)"
+        installer="pipx"
+    elif command -v uv &> /dev/null; then
         log_success "'uv' found - using ultrafast Python package manager"
         installer="uv"
     elif command -v pip3 &> /dev/null || command -v pip &> /dev/null; then
         log_success "'pip' found - using standard Python package installer"
         installer="pip"
     else
-        # Neither uv nor pip found
-        log_error "Neither 'uv' nor 'pip' package manager found!"
+        # No package manager found
+        log_error "No suitable package manager found!"
         echo ""
         log_info "Please install one of the following:"
         echo ""
-        echo "  Option 1: Install 'uv' (recommended - ultrafast)"
+        if [ "$is_ext_managed" = true ]; then
+            echo "  Option 1: Install 'pipx' (RECOMMENDED for Ubuntu/Debian)"
+            echo "    sudo apt install pipx"
+            echo "    pipx ensurepath"
+            echo ""
+        fi
+        echo "  Option 2: Install 'uv' (ultrafast Python package manager)"
         echo "    curl -LsSf https://astral.sh/uv/install.sh | sh"
         echo "    OR"
         echo "    brew install uv  (macOS)"
         echo ""
-        echo "  Option 2: Install 'pip' (standard Python package manager)"
+        echo "  Option 3: Install 'pip' (standard Python package manager)"
         echo "    python3 -m ensurepip --upgrade"
         echo "    OR"
         echo "    curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py && python3 get-pip.py"
         echo ""
+        if [ "$is_ext_managed" = true ]; then
+            log_info "Note: On Ubuntu/Debian with externally managed Python, 'pipx' is recommended"
+            log_info "Alternatively, install python3-venv: sudo apt install python3-venv python3-full"
+        fi
+        echo ""
         exit 1
     fi
 
@@ -224,10 +439,25 @@ main() {
     log_info "Installing required packages: ${REQUIRED_PACKAGES[*]}"
     echo ""
 
-    if [ "$installer" = "uv" ]; then
+    if [ "$installer" = "pipx" ]; then
+        if install_with_pipx; then
+            echo ""
+            log_success "All packages installed successfully using 'pipx'!"
+            log_info "Packages installed in isolated environments and added to PATH"
+            echo ""
+            exit 0
+        else
+            log_error "Some packages failed to install with 'pipx'"
+            exit 1
+        fi
+    elif [ "$installer" = "uv" ]; then
         if install_with_uv; then
             echo ""
             log_success "All packages installed successfully using 'uv'!"
+            if [ -d ".venv_juno" ]; then
+                log_info "Packages installed in virtual environment: .venv_juno"
+                log_info "To use them, activate the venv: source .venv_juno/bin/activate"
+            fi
             echo ""
             exit 0
         else
@@ -238,6 +468,10 @@ main() {
         if install_with_pip; then
             echo ""
             log_success "All packages installed successfully using 'pip'!"
+            if [ -d ".venv_juno" ]; then
+                log_info "Packages installed in virtual environment: .venv_juno"
+                log_info "To use them, activate the venv: source .venv_juno/bin/activate"
+            fi
             echo ""
             exit 0
         else

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "juno-code",
-  "version": "1.0.12",
-  "description": "AI Subagent Orchestration CLI - Code-focused package for juno-task-ts providing Claude Code integration and MCP server orchestration",
+  "version": "1.0.14",
+  "description": "AI Subagent Orchestration CLI - Professional TypeScript CLI for AI-powered code intelligence, MCP server orchestration, and subagent collaboration",
   "keywords": [
     "ai",
     "code",
@@ -35,6 +35,9 @@
     "README.md",
     "CHANGELOG.md"
   ],
+  "scripts": {
+    "build:copy-wrapper": "node -e \"const fs = require('fs-extra'); fs.copySync('src/bin/juno-code.sh', 'dist/bin/juno-code.sh'); fs.chmodSync('dist/bin/juno-code.sh', 0o755);\""
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.0",
     "chalk": "^5.3.0",
@@ -61,12 +64,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/owner/juno-task-ts.git"
+    "url": "https://github.com/owner/juno-code.git"
   },
   "bugs": {
-    "url": "https://github.com/owner/juno-task-ts/issues"
+    "url": "https://github.com/owner/juno-code/issues"
   },
-  "homepage": "https://github.com/owner/juno-task-ts#readme",
+  "homepage": "https://github.com/owner/juno-code#readme",
   "license": "MIT",
   "author": {
     "name": "Development Team",