release: v1.5.0 - updated optimizer logic and docs

Author: babakskr

AI_DEV.sh

@@ -0,0 +1,47 @@
+
+#!/bin/bash
+
+# 1. Define Version and Release Info
+DOC_VERSION="v1.0.0-docs"
+RELEASE_TITLE="📚 Protocol Update: AI Development Guidelines"
+RELEASE_NOTES="
+## 🚀 Official AI Development Guidelines
+
+We have established a standardized protocol for AI-assisted development to ensure code quality, security, and stability.
+
+### 📄 New File: \`AI_DEV_GUIDELINES.md\`
+This document contains the **System Prompts** (English & Persian) that must be used when generating code for this repository.
+
+### ✨ Key Standards Enforced:
+* **Immutability:** Preventing regressions in existing code.
+* **Minimal Dependencies:** Prioritizing native Bash solutions.
+* **Security:** Mandatory audits for every code snippet.
+* **Dual Language:** Support for both English and Persian workflows.
+"
+
+# 2. Stage and Commit the new file
+echo ">> Staging AI_DEV_GUIDELINES.md..."
+git add AI_DEV_GUIDELINES.md
+git commit -m "docs: add comprehensive AI development guidelines (En/Fa)"
+
+# 3. Create a Git Tag
+echo ">> Creating Tag $DOC_VERSION..."
+git tag -a "$DOC_VERSION" -m "Release $DOC_VERSION: Added AI Guidelines"
+
+# 4. Push Changes and Tags to GitHub
+echo ">> Pushing to Origin..."
+git push origin main
+git push origin "$DOC_VERSION"
+
+# 5. Create GitHub Release (Requires GitHub CLI 'gh')
+if command -v gh &> /dev/null; then
+    echo ">> Creating GitHub Release automatically..."
+    gh release create "$DOC_VERSION" \
+       --title "$RELEASE_TITLE" \
+       --notes "$RELEASE_NOTES"
+    echo "✅ Release created successfully on GitHub!"
+else
+    echo "⚠️  GitHub CLI (gh) not found."
+    echo ">> Please manually create a release on GitHub for tag: $DOC_VERSION"
+    echo ">> Use the Release Notes provided in the script above."
+fi

README.md

@@ -1,27 +1,59 @@
-Conduit Console ManagerConduit Console is a robust, terminal-based management dashboard for the Psiphon Conduit volunteer proxy node.This tool provides a native "Console" experience for server administrators, offering real-time status reports, action logs, and easier management of the Conduit service without needing complex manual commands.
-(Screenshots coming soon)
+# Conduit Console & Optimizer Tools
+> **Repository:** [https://github.com/babakskr/Conduit-console](https://github.com/babakskr/Conduit-console)  
+> **Maintainer:** Babak Sorkhpour  
+> **Latest Version:** 1.5.0
 
-✨ FeaturesNative Dashboard:
-A clean, text-based user interface (TUI) for monitoring your node.
-Action Reports: Detailed logs of node activities and interventions.
-Status Totals: Real-time aggregation of connection stats and bandwidth usage.Lightweight: Written purely in Shell, requiring minimal dependencies.
-Version Control: Built-in update checks and version tracking (currently v0.1.1).
-🚀 InstallationYou can install Conduit-console by cloning the repository directly to your server:
-# 1. Update your package list
+## 🛠 Project Tools Overview
 
-sudo apt update && sudo apt install git -y
+| Tool File | Description | Usage |
+| :--- | :--- | :--- |
+| `conduit-optimizer.sh` | Performance tuner for Docker & Native instances. Adjusts CPU/IO Priority. | `sudo ./conduit-optimizer.sh -h` |
+| `AI_DEV_GUIDELINES.md` | Protocol and System Prompts for AI-assisted development (En/Fa). | Reference Doc |
+| `git_op.sh` | Automated Release Manager & README Generator. | `./git_op.sh` |
 
-# 2. Clone the repository
-git clone [https://github.com/babakskr/Conduit-console.git](https://github.com/babakskr/Conduit-console.git)
+## 🚀 How to Use: Conduit Optimizer
 
-# 3. Enter the directory and make it executable
+The optimizer intelligently adjusts the Linux Priority (PRI) of your running Conduit processes to prevent lag.
+
+### Installation
+```bash
+git clone https://github.com/babakskr/Conduit-console.git
 cd Conduit-console
-chmod +x conduit-console.sh
-
-# 4. Run the console
-./conduit-console.sh
-📖 UsageOnce installed, simply run the script to enter the main dashboard:
-./conduit-console.sh
-From the menu, you can access:Start/Stop the Conduit service.View Live Logs.Check Total Status (Connections/Bandwidth).Generate Action Reports.🤝 Credits & AcknowledgementsThis project is an independent management tool built upon the shoulders of giants. Special thanks to the core developers and the open-source community:ssmirr/conduit: The core Conduit server implementation. This project wraps the functionality provided by ssmirr's incredible work.SamNet-dev/conduit-manager: Inspiration for the management structure and automation flows.
-⚖️ LicenseThis project is licensed under the MIT License. See the LICENSE file for details.Disclaimer: This tool is not officially affiliated with Psiphon Inc.
-It is a community-driven manager for the volunteer Conduit network.
+chmod +x conduit-optimizer.sh
+```
+
+### Basic Usage (Default Mode)
+Automatically sets **Docker to PRI 10** (High) and **Native to PRI 15** (Medium-High).
+```bash
+sudo ./conduit-optimizer.sh
+```
+
+### Custom Usage (CLI Arguments)
+You can manually set the target Priority (Range 5-20). 
+*Lower value = Higher Priority in manual input? No, we follow Linux PRI logic:*
+* **10**: Very High Priority (Nice -10)
+* **20**: Normal Priority (Nice 0)
+
+```bash
+# Example: Set Docker to PRI 10 and Native to PRI 18 (almost normal)
+sudo ./conduit-optimizer.sh -dock 10 -srv 18
+
+# Example: Skip Docker, only optimize Service to PRI 5 (Maximum Power)
+sudo ./conduit-optimizer.sh -dock 0 -srv 5
+
+# Get Help
+./conduit-optimizer.sh -h
+```
+
+## 📜 Latest Release Notes (1.5.0)
+## ?? Release v1.5.0: CLI & Custom Priorities
+#
+**Key Changes:**
+* **New CLI Args:** Added `-dock` and `-srv` to set custom target priorities manually.
+* **Logic Update:** Inputs now map to Linux PRI column (Target 10 = Nice -10).
+* **Verbose Mode:** Added `-v` for detailed output logging.
+* **Help Menu:** Added `-h` for quick usage guide.
+* **Safety Range:** Inputs restricted to 5-20 (0 to skip).
+
+---
+*Auto-generated by git_op.sh*

conduit-optimizer.sh

@@ -1,16 +1,38 @@
 #!/bin/bash
 # ==============================================================================
 # Project: Conduit-console | Module: Performance Optimizer
+# Repo: https://github.com/babakskr/Conduit-console.git
 # Author: Babak Sorkhpour (Assisted by Gemini Pro)
 # License: MIT
-# Version: 1.4.0
-# Description: Improved Docker detection (Image & Name) + Execution Fixes.
+# Version: 1.5.0
 # ==============================================================================
 
-# --- Configuration ---
-PRIORITY_NATIVE_NICE=-5
-PRIORITY_DOCKER_NICE=-10  # Higher priority for Docker
-TARGET_IONICE_CLASS=2 
+# --- RELEASE NOTES (Auto-parsed by git_op.sh) ---
+# <release_notes>
+# ## ?? Release v1.5.0: CLI & Custom Priorities
+#
+# **Key Changes:**
+# * **New CLI Args:** Added `-dock` and `-srv` to set custom target priorities manually.
+# * **Logic Update:** Inputs now map to Linux PRI column (Target 10 = Nice -10).
+# * **Verbose Mode:** Added `-v` for detailed output logging.
+# * **Help Menu:** Added `-h` for quick usage guide.
+# * **Safety Range:** Inputs restricted to 5-20 (0 to skip).
+# </release_notes>
+
+# --- DEFAULTS ---
+# Default Target PRI (Linux Priority Column):
+# 10 = High Priority (Nice -10) -> For Docker
+# 15 = Medium-High Priority (Nice -5) -> For Native Services
+DEFAULT_DOCKER_PRI=10
+DEFAULT_NATIVE_PRI=15
+
+# Inputs (Initialized with Defaults)
+INPUT_DOCKER_PRI=$DEFAULT_DOCKER_PRI
+INPUT_NATIVE_PRI=$DEFAULT_NATIVE_PRI
+VERBOSE=0
+
+# --- CONFIG ---
+TARGET_IONICE_CLASS=2
 TARGET_IONICE_LEVEL=0
 
 # Colors
@@ -20,89 +42,156 @@ YELLOW='\033[1;33m'
 RED='\033[0;31m'
 NC='\033[0m'
 
-# --- Root Check ---
+# --- FUNCTIONS ---
+
+show_help() {
+    echo -e "${BLUE}Conduit Performance Optimizer v1.5.0${NC}"
+    echo -e "Repo: https://github.com/babakskr/Conduit-console.git"
+    echo ""
+    echo "Usage: sudo $0 [OPTIONS]"
+    echo ""
+    echo "Options:"
+    echo "  -h          Show this help message"
+    echo "  -v          Verbose mode (show detailed logs)"
+    echo "  -dock <val> Set Target Priority for Docker (Range: 5-20, Default: 10, 0: Skip)"
+    echo "  -srv  <val> Set Target Priority for Native Services (Range: 5-20, Default: 15, 0: Skip)"
+    echo ""
+    echo "Concept:"
+    echo "  Value matches Linux 'PRI' column."
+    echo "  10 = Very High (Nice -10)"
+    echo "  15 = High (Nice -5)"
+    echo "  20 = Normal (Nice 0)"
+    echo ""
+}
+
+log_verbose() {
+    if [[ $VERBOSE -eq 1 ]]; then
+        echo -e "$1"
+    fi
+}
+
+validate_input() {
+    local val=$1
+    local name=$2
+    if [[ "$val" -eq 0 ]]; then
+        return 0 # 0 means skip
+    fi
+    if [[ "$val" -lt 5 || "$val" -gt 20 ]]; then
+        echo -e "${RED}[ERROR] $name priority must be between 5 and 20 (or 0 to skip).${NC}"
+        exit 1
+    fi
+}
+
+calc_nice() {
+    # Formula: Nice = Target_PRI - 20
+    # Example: Input 10 -> 10 - 20 = -10 (Nice)
+    echo $(( $1 - 20 ))
+}
+
+# --- CLI PARSING ---
+while getopts "hvd:s:" opt; do
+  case ${opt} in
+    h ) show_help; exit 0 ;;
+    v ) VERBOSE=1 ;;
+    d ) INPUT_DOCKER_PRI=$OPTARG ;;
+    s ) INPUT_NATIVE_PRI=$OPTARG ;;
+    \? ) show_help; exit 1 ;;
+  esac
+done
+
+# --- ROOT CHECK ---
 if [[ $EUID -ne 0 ]]; then
    echo -e "${RED}[ERROR] Root privileges required.${NC}"
    exit 1
 fi
 
-echo -e "${GREEN}Starting Conduit Optimizer v1.4.0${NC}"
+# --- VALIDATION ---
+validate_input "$INPUT_DOCKER_PRI" "Docker"
+validate_input "$INPUT_NATIVE_PRI" "Native Service"
+
+echo -e "${GREEN}Starting Conduit Optimizer v1.5.0${NC}"
 echo -e "Author: Babak Sorkhpour"
 echo "---------------------------------------------------"
+if [[ $INPUT_NATIVE_PRI -gt 0 ]]; then
+    echo -e "Target Native PRI : ${YELLOW}$INPUT_NATIVE_PRI${NC} (Nice $(calc_nice $INPUT_NATIVE_PRI))"
+else
+    echo -e "Target Native PRI : ${YELLOW}SKIPPING${NC}"
+fi
+if [[ $INPUT_DOCKER_PRI -gt 0 ]]; then
+    echo -e "Target Docker PRI : ${RED}$INPUT_DOCKER_PRI${NC} (Nice $(calc_nice $INPUT_DOCKER_PRI))"
+else
+    echo -e "Target Docker PRI : ${YELLOW}SKIPPING${NC}"
+fi
+echo "---------------------------------------------------"
 
-# Track PIDs to prevent double optimization (Native vs Docker overlap)
+# Track PIDs
 declare -A PROCESSED_PIDS
+TOTAL_SUCCESS=0
 
 # ==============================================================================
-# SECTION 1: DOCKER OPTIMIZATION (Priority 1)
-# We run this FIRST to ensure Docker processes get the higher priority (-10)
-# even if they are also detected by the native scanner later.
+# PHASE 1: DOCKER
 # ==============================================================================
-echo -e "${BLUE}>> Phase 1: Scanning Docker Containers (Image & Name)...${NC}"
-
-if command -v docker &>/dev/null; then
-    # Search for containers where Image OR Name contains "conduit"
-    # format: ID | Image | Names
-    DOCKER_CANDIDATES=$(docker ps --format "{{.ID}} {{.Image}} {{.Names}}" | grep -i "conduit")
-
-    if [[ -n "$DOCKER_CANDIDATES" ]]; then
-        # Read line by line
-        while read -r LINE; do
-            CID=$(echo "$LINE" | awk '{print $1}')
-            C_INFO=$(echo "$LINE" | awk '{$1=""; print $0}') # Rest of the string
-            
-            # Get Host PID
-            CPID=$(docker inspect --format '{{.State.Pid}}' "$CID" 2>/dev/null)
-
-            if [[ -n "$CPID" && "$CPID" -gt 0 ]]; then
-                renice -n "$PRIORITY_DOCKER_NICE" -p "$CPID" &>/dev/null
-                ionice -c "$TARGET_IONICE_CLASS" -n "$TARGET_IONICE_LEVEL" -p "$CPID" &>/dev/null
-                
-                PROCESSED_PIDS[$CPID]=1
-                echo -e "   [Docker] Container $CID ($C_INFO)"
-                echo -e "            PID: $CPID -> Nice $PRIORITY_DOCKER_NICE: ${GREEN}OK${NC}"
-            fi
-        done <<< "$DOCKER_CANDIDATES"
-    else
-        echo -e "   ${YELLOW}No active containers matching 'conduit' found.${NC}"
-        echo -e "   (Debug: Ensure 'docker ps' shows running containers)"
+if [[ $INPUT_DOCKER_PRI -gt 0 ]]; then
+    log_verbose "${BLUE}>> Phase 1: Scanning Docker Containers...${NC}"
+    
+    TARGET_NICE=$(calc_nice $INPUT_DOCKER_PRI)
+
+    if command -v docker &>/dev/null; then
+        DOCKER_CANDIDATES=$(docker ps --format "{{.ID}} {{.Image}} {{.Names}}" | grep -i "conduit")
+        
+        if [[ -n "$DOCKER_CANDIDATES" ]]; then
+            while read -r LINE; do
+                CID=$(echo "$LINE" | awk '{print $1}')
+                C_INFO=$(echo "$LINE" | awk '{$1=""; print $0}')
+                CPID=$(docker inspect --format '{{.State.Pid}}' "$CID" 2>/dev/null)
+
+                if [[ -n "$CPID" && "$CPID" -gt 0 ]]; then
+                    renice -n "$TARGET_NICE" -p "$CPID" &>/dev/null
+                    ionice -c "$TARGET_IONICE_CLASS" -n "$TARGET_IONICE_LEVEL" -p "$CPID" &>/dev/null
+                    
+                    PROCESSED_PIDS[$CPID]=1
+                    echo -e "   [Docker] Container $CID -> PRI $INPUT_DOCKER_PRI: ${GREEN}OK${NC}"
+                    log_verbose "            (Info: $C_INFO)"
+                    ((TOTAL_SUCCESS++))
+                fi
+            done <<< "$DOCKER_CANDIDATES"
+        else
+            log_verbose "   No active Docker containers found."
+        fi
     fi
-else
-    echo -e "   Docker not installed or not in PATH."
 fi
 
 # ==============================================================================
-# SECTION 2: NATIVE OPTIMIZATION (Priority 2)
+# PHASE 2: NATIVE
 # ==============================================================================
-echo -e "${BLUE}>> Phase 2: Scanning Native Processes...${NC}"
-
-NATIVE_PIDS=$(pgrep -f "/opt/conduit.*/conduit")
+if [[ $INPUT_NATIVE_PRI -gt 0 ]]; then
+    log_verbose "${BLUE}>> Phase 2: Scanning Native Processes...${NC}"
+    
+    TARGET_NICE=$(calc_nice $INPUT_NATIVE_PRI)
+    NATIVE_PIDS=$(pgrep -f "/opt/conduit.*/conduit")
 
-if [[ -n "$NATIVE_PIDS" ]]; then
-    for PID in $NATIVE_PIDS; do
-        # Skip if already optimized as Docker
-        if [[ ${PROCESSED_PIDS[$PID]} ]]; then
-            continue
-        fi
+    if [[ -n "$NATIVE_PIDS" ]]; then
+        for PID in $NATIVE_PIDS; do
+            if [[ ${PROCESSED_PIDS[$PID]} ]]; then continue; fi
 
-        renice -n "$PRIORITY_NATIVE_NICE" -p "$PID" &>/dev/null
-        ionice -c "$TARGET_IONICE_CLASS" -n "$TARGET_IONICE_LEVEL" -p "$PID" &>/dev/null
-        
-        echo -e "   [Native] PID: $PID -> Nice $PRIORITY_NATIVE_NICE: ${GREEN}OK${NC}"
-        PROCESSED_PIDS[$PID]=1
-    done
-else
-    echo -e "   No native processes found."
+            renice -n "$TARGET_NICE" -p "$PID" &>/dev/null
+            ionice -c "$TARGET_IONICE_CLASS" -n "$TARGET_IONICE_LEVEL" -p "$PID" &>/dev/null
+            
+            echo -e "   [Native] PID: $PID -> PRI $INPUT_NATIVE_PRI: ${GREEN}OK${NC}"
+            PROCESSED_PIDS[$PID]=1
+            ((TOTAL_SUCCESS++))
+        done
+    else
+        log_verbose "   No native processes found."
+    fi
 fi
 
 # ==============================================================================
-# SECTION 3: VERIFICATION
+# PHASE 3: VERIFICATION
 # ==============================================================================
 echo "---------------------------------------------------"
-echo -e "${YELLOW}>> Phase 3: Final Verification${NC}"
-COUNT=${#PROCESSED_PIDS[@]}
-if [[ $COUNT -gt 0 ]]; then
-    echo -e "${GREEN}>> SUCCESS: Optimized $COUNT processes.${NC}"
+if [[ $TOTAL_SUCCESS -gt 0 ]]; then
+    echo -e "${GREEN}>> SUCCESS: Optimized $TOTAL_SUCCESS processes.${NC}"
 else
-    echo -e "${RED}>> WARNING: No processes were optimized.${NC}"
+    echo -e "${YELLOW}>> DONE: No eligible processes found or operations skipped.${NC}"
 fi