agentk8 1.0.0 → 1.0.2

package/README.md

@@ -64,19 +64,21 @@ curl -sSL https://raw.githubusercontent.com/de5truct0/agentk/main/install.sh | b
 ### Homebrew (macOS/Linux)
 ```bash
 brew tap de5truct0/agentk
-brew install agentk
+brew install agentk8
 ```
 
 ### npm
 ```bash
-npm install -g agentk
+npm install -g agentk8
 ```
 
 ### pip
 ```bash
-pip install agentk
+pip install agentk8
 ```
 
+> **Note**: Package name is `agentk8` on all registries. The installed command is `agentk`.
+
 ### From Source
 ```bash
 git clone https://github.com/de5truct0/agentk.git

package/agentk

@@ -8,14 +8,14 @@ set -euo pipefail
 # INITIALIZATION
 # =============================================================================
 
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-export AGENTK_ROOT="$SCRIPT_DIR"
+_AGENTK_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+export AGENTK_ROOT="$_AGENTK_SCRIPT_DIR"
 
-# Source libraries
-source "$SCRIPT_DIR/lib/core.sh"
-source "$SCRIPT_DIR/lib/ui.sh"
-source "$SCRIPT_DIR/lib/ipc.sh"
-source "$SCRIPT_DIR/lib/spawn.sh"
+# Source libraries (use AGENTK_ROOT to avoid variable scope issues)
+source "$AGENTK_ROOT/lib/core.sh"
+source "$AGENTK_ROOT/lib/ui.sh"
+source "$AGENTK_ROOT/lib/ipc.sh"
+source "$AGENTK_ROOT/lib/spawn.sh"
 
 # =============================================================================
 # CONFIGURATION
@@ -186,19 +186,21 @@ handle_command() {
 cmd_status() {
     print_section "Agent Status"
 
-    local agents=()
+    local agents
     case "$AGENTK_MODE" in
-        dev) agents=("orchestrator" "engineer" "tester" "security" "scout") ;;
-        ml)  agents=("orchestrator" "researcher" "ml-engineer" "data-engineer" "evaluator" "scout") ;;
+        dev) agents="orchestrator engineer tester security scout" ;;
+        ml)  agents="orchestrator researcher ml-engineer data-engineer evaluator scout" ;;
     esac
 
-    for agent in "${agents[@]}"; do
+    for agent in $agents; do
         local status
         status=$(get_agent_status "$agent")
         local message=""
+        local task_id
+        task_id=$(_get_agent_task "$agent" 2>/dev/null || echo "")
 
-        if [[ -n "${AGENT_TASKS[$agent]:-}" ]]; then
-            message=$(get_task_field "${AGENT_TASKS[$agent]}" "prompt" | head -c 40)
+        if [[ -n "$task_id" ]]; then
+            message=$(get_task_field "$task_id" "prompt" 2>/dev/null | head -c 40)
             [[ ${#message} -eq 40 ]] && message="${message}..."
         fi
 
@@ -279,7 +281,7 @@ cmd_visual() {
 cmd_exit() {
     print_info "Ending session..."
     end_session
-    cleanup_agents
+    kill_all_agents
     echo
     echo "${GREEN}Goodbye!${RESET}"
     exit 0

package/lib/core.sh

@@ -8,7 +8,7 @@ set -euo pipefail
 # CONSTANTS
 # =============================================================================
 
-AGENTK_VERSION="1.0.0"
+AGENTK_VERSION="1.0.2"
 AGENTK_ROOT="${AGENTK_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
 AGENTK_WORKSPACE="${AGENTK_ROOT}/workspace"
 CLAUDE_KNOWLEDGE_CUTOFF="2024-04"
@@ -38,9 +38,18 @@ fi
 # LOGGING
 # =============================================================================
 
-# Log levels
+# Log levels (bash 3.x compatible - no associative arrays)
 LOG_LEVEL="${LOG_LEVEL:-info}"
-declare -A LOG_LEVELS=([debug]=0 [info]=1 [warn]=2 [error]=3)
+
+_get_log_level_num() {
+    case "$1" in
+        debug) echo 0 ;;
+        info)  echo 1 ;;
+        warn)  echo 2 ;;
+        error) echo 3 ;;
+        *)     echo 1 ;;
+    esac
+}
 
 _log() {
     local level="$1"
@@ -49,8 +58,10 @@ _log() {
     timestamp=$(date '+%Y-%m-%d %H:%M:%S')
 
     # Check if we should log this level
-    local current_level=${LOG_LEVELS[${LOG_LEVEL}]:-1}
-    local msg_level=${LOG_LEVELS[${level}]:-1}
+    local current_level
+    current_level=$(_get_log_level_num "$LOG_LEVEL")
+    local msg_level
+    msg_level=$(_get_log_level_num "$level")
 
     if [[ $msg_level -ge $current_level ]]; then
         case "$level" in
@@ -220,21 +231,20 @@ generate_task_id() {
 # =============================================================================
 
 check_dependencies() {
-    local missing=()
-
-    # Required
-    command -v jq &>/dev/null || missing+=("jq")
-    command -v claude &>/dev/null || missing+=("claude")
-
-    # Check bash version
-    if [[ "${BASH_VERSION%%.*}" -lt 4 ]]; then
-        log_error "Bash 4.0+ required. Current: $BASH_VERSION"
-        exit 1
-    fi
-
-    if [[ ${#missing[@]} -gt 0 ]]; then
-        log_error "Missing dependencies: ${missing[*]}"
-        log_info "Install with: brew install ${missing[*]}"
+    local has_jq has_claude
+    has_jq=$(command -v jq 2>/dev/null)
+    has_claude=$(command -v claude 2>/dev/null)
+
+    # Check required dependencies
+    if [[ -z "$has_jq" ]] || [[ -z "$has_claude" ]]; then
+        if [[ -z "$has_jq" ]]; then
+            log_error "Missing dependency: jq"
+            log_info "Install with: brew install jq"
+        fi
+        if [[ -z "$has_claude" ]]; then
+            log_error "Missing dependency: claude (Claude Code CLI)"
+            log_info "Install from: https://claude.ai/code"
+        fi
         exit 1
     fi
 

package/lib/ipc.sh

@@ -4,9 +4,11 @@
 
 set -euo pipefail
 
-# Source core for utilities
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/core.sh"
+# Source core for utilities (use AGENTK_ROOT if set, otherwise compute local path)
+_IPC_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [[ -z "${AGENTK_ROOT:-}" ]]; then
+    source "$_IPC_SCRIPT_DIR/core.sh"
+fi
 
 # =============================================================================
 # TASK STATUS CONSTANTS

package/lib/spawn.sh

@@ -1,21 +1,89 @@
 #!/usr/bin/env bash
 # AGENT-K Spawn Library
 # Claude subprocess spawning and management
+# Compatible with bash 3.x (no associative arrays)
 
 set -euo pipefail
 
-# Source dependencies
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/core.sh"
-source "$SCRIPT_DIR/ipc.sh"
+# Source dependencies (use AGENTK_ROOT if set, otherwise compute local path)
+_SPAWN_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [[ -z "${AGENTK_ROOT:-}" ]]; then
+    source "$_SPAWN_SCRIPT_DIR/core.sh"
+    source "$_SPAWN_SCRIPT_DIR/ipc.sh"
+fi
 
 # =============================================================================
-# GLOBALS
+# PID FILE MANAGEMENT (bash 3.x compatible)
 # =============================================================================
 
-# Track spawned agent PIDs
-declare -A AGENT_PIDS=()
-declare -A AGENT_TASKS=()
+_get_agent_pid_file() {
+    local agent="$1"
+    echo "$AGENTK_WORKSPACE/.pids/${agent}.pid"
+}
+
+_get_agent_task_file() {
+    local agent="$1"
+    echo "$AGENTK_WORKSPACE/.pids/${agent}.task"
+}
+
+_set_agent_pid() {
+    local agent="$1"
+    local pid="$2"
+    local pid_dir="$AGENTK_WORKSPACE/.pids"
+    mkdir -p "$pid_dir"
+    echo "$pid" > "$(_get_agent_pid_file "$agent")"
+}
+
+_get_agent_pid() {
+    local agent="$1"
+    local pid_file
+    pid_file="$(_get_agent_pid_file "$agent")"
+    if [[ -f "$pid_file" ]]; then
+        cat "$pid_file"
+    else
+        echo ""
+    fi
+}
+
+_clear_agent_pid() {
+    local agent="$1"
+    rm -f "$(_get_agent_pid_file "$agent")"
+}
+
+_set_agent_task() {
+    local agent="$1"
+    local task_id="$2"
+    local pid_dir="$AGENTK_WORKSPACE/.pids"
+    mkdir -p "$pid_dir"
+    echo "$task_id" > "$(_get_agent_task_file "$agent")"
+}
+
+_get_agent_task() {
+    local agent="$1"
+    local task_file
+    task_file="$(_get_agent_task_file "$agent")"
+    if [[ -f "$task_file" ]]; then
+        cat "$task_file"
+    else
+        echo ""
+    fi
+}
+
+_clear_agent_task() {
+    local agent="$1"
+    rm -f "$(_get_agent_task_file "$agent")"
+}
+
+_list_active_agents() {
+    local pid_dir="$AGENTK_WORKSPACE/.pids"
+    if [[ -d "$pid_dir" ]]; then
+        for pid_file in "$pid_dir"/*.pid; do
+            if [[ -f "$pid_file" ]]; then
+                basename "$pid_file" .pid
+            fi
+        done
+    fi
+}
 
 # =============================================================================
 # AGENT PROMPT LOADING
@@ -144,8 +212,8 @@ Context Files: $context_files"
     ) >> "$log_file" 2>&1 &
 
     local pid=$!
-    AGENT_PIDS[$agent]=$pid
-    AGENT_TASKS[$agent]=$task_id
+    _set_agent_pid "$agent" "$pid"
+    _set_agent_task "$agent" "$task_id"
 
     log_debug "Agent $agent spawned with PID: $pid"
     echo "$pid"
@@ -185,16 +253,18 @@ spawn_agent_interactive() {
 is_agent_running() {
     local agent="$1"
 
-    if [[ -z "${AGENT_PIDS[$agent]:-}" ]]; then
+    local pid
+    pid=$(_get_agent_pid "$agent")
+
+    if [[ -z "$pid" ]]; then
         return 1
     fi
 
-    local pid="${AGENT_PIDS[$agent]}"
     if kill -0 "$pid" 2>/dev/null; then
         return 0
     else
         # Agent finished, clean up
-        unset AGENT_PIDS[$agent]
+        _clear_agent_pid "$agent"
         return 1
     fi
 }
@@ -203,12 +273,14 @@ wait_agent() {
     local agent="$1"
     local timeout="${2:-300}"
 
-    if [[ -z "${AGENT_PIDS[$agent]:-}" ]]; then
+    local pid
+    pid=$(_get_agent_pid "$agent")
+
+    if [[ -z "$pid" ]]; then
         log_warn "Agent not running: $agent"
         return 1
     fi
 
-    local pid="${AGENT_PIDS[$agent]}"
     local elapsed=0
 
     while kill -0 "$pid" 2>/dev/null && [[ $elapsed -lt $timeout ]]; do
@@ -223,7 +295,7 @@ wait_agent() {
 
     # Get exit status
     wait "$pid" 2>/dev/null || true
-    unset AGENT_PIDS[$agent]
+    _clear_agent_pid "$agent"
 
     log_debug "Agent $agent finished"
     return 0
@@ -232,13 +304,14 @@ wait_agent() {
 kill_agent() {
     local agent="$1"
 
-    if [[ -z "${AGENT_PIDS[$agent]:-}" ]]; then
+    local pid
+    pid=$(_get_agent_pid "$agent")
+
+    if [[ -z "$pid" ]]; then
         log_warn "Agent not running: $agent"
         return 0
     fi
 
-    local pid="${AGENT_PIDS[$agent]}"
-
     # Try graceful shutdown first
     kill -TERM "$pid" 2>/dev/null || true
     sleep 1
@@ -249,19 +322,22 @@ kill_agent() {
     fi
 
     # Cancel any active task
-    if [[ -n "${AGENT_TASKS[$agent]:-}" ]]; then
-        cancel_task "${AGENT_TASKS[$agent]}"
-        unset AGENT_TASKS[$agent]
+    local task_id
+    task_id=$(_get_agent_task "$agent")
+    if [[ -n "$task_id" ]]; then
+        cancel_task "$task_id"
+        _clear_agent_task "$agent"
     fi
 
-    unset AGENT_PIDS[$agent]
+    _clear_agent_pid "$agent"
     update_session_agent "$agent" "stopped" "Killed by user"
 
     log_info "Killed agent: $agent"
 }
 
 kill_all_agents() {
-    for agent in "${!AGENT_PIDS[@]}"; do
+    local agent
+    for agent in $(_list_active_agents); do
         kill_agent "$agent"
     done
 }
@@ -275,124 +351,52 @@ get_agent_status() {
 
     if is_agent_running "$agent"; then
         echo "running"
-    elif [[ -n "${AGENT_TASKS[$agent]:-}" ]]; then
-        local task_status
-        task_status=$(get_task_status "${AGENT_TASKS[$agent]}")
-        echo "$task_status"
     else
-        echo "idle"
+        local task_id
+        task_id=$(_get_agent_task "$agent")
+        if [[ -n "$task_id" ]]; then
+            local task_status
+            task_status=$(get_task_status "$task_id")
+            echo "$task_status"
+        else
+            echo "idle"
+        fi
     fi
 }
 
 get_all_agent_status() {
     local mode="${1:-dev}"
-    local agents=()
+    local agents
 
     case "$mode" in
-        dev) agents=("orchestrator" "engineer" "tester" "security" "scout") ;;
-        ml)  agents=("orchestrator" "researcher" "ml-engineer" "data-engineer" "evaluator" "scout") ;;
+        dev) agents="orchestrator engineer tester security scout" ;;
+        ml)  agents="orchestrator researcher ml-engineer data-engineer evaluator scout" ;;
+        *)   agents="orchestrator engineer tester security scout" ;;
     esac
 
     echo "{"
     local first=true
-    for agent in "${agents[@]}"; do
+    for agent in $agents; do
         local status
         status=$(get_agent_status "$agent")
-        local message=""
-
-        if [[ -n "${AGENT_TASKS[$agent]:-}" ]]; then
-            message=$(get_task_field "${AGENT_TASKS[$agent]}" "prompt" | head -c 50)
-        fi
 
         if [[ "$first" == "true" ]]; then
             first=false
         else
             echo ","
         fi
-
-        printf '  "%s": {"status": "%s", "message": "%s"}' "$agent" "$status" "$message"
+        echo "  \"$agent\": \"$status\""
     done
-    echo
     echo "}"
 }
 
-# =============================================================================
-# AGENT LOG VIEWING
-# =============================================================================
-
-view_agent_log() {
-    local agent="$1"
-    local lines="${2:-50}"
-
-    local log_file
-    log_file=$(get_agent_log "$agent")
-
-    if [[ -f "$log_file" ]]; then
-        tail -n "$lines" "$log_file"
-    else
-        echo "No logs found for agent: $agent"
-    fi
-}
-
-follow_agent_log() {
-    local agent="$1"
-
-    local log_file
-    log_file=$(get_agent_log "$agent")
-
-    if [[ -f "$log_file" ]]; then
-        tail -f "$log_file"
-    else
-        echo "No logs found for agent: $agent"
-    fi
-}
-
-clear_agent_log() {
-    local agent="$1"
-
-    local log_file
-    log_file=$(get_agent_log "$agent")
-
-    if [[ -f "$log_file" ]]; then
-        > "$log_file"
-        log_debug "Cleared log for agent: $agent"
-    fi
-}
-
-# =============================================================================
-# PARALLEL SPAWNING
-# =============================================================================
-
-spawn_agents_parallel() {
-    local mode="$1"
-    shift
-    local task_ids=("$@")
-
-    local pids=()
-
-    for task_id in "${task_ids[@]}"; do
-        local assigned_to
-        assigned_to=$(get_task_field "$task_id" "assigned_to")
-
-        spawn_agent "$assigned_to" "$task_id" "$mode" &
-        pids+=($!)
-    done
-
-    # Wait for all spawns to complete
-    for pid in "${pids[@]}"; do
-        wait "$pid" 2>/dev/null || true
+get_running_agent_count() {
+    local count=0
+    local agent
+    for agent in $(_list_active_agents); do
+        if is_agent_running "$agent"; then
+            count=$((count + 1))
+        fi
     done
+    echo "$count"
 }
-
-# =============================================================================
-# CLEANUP
-# =============================================================================
-
-cleanup_agents() {
-    log_info "Cleaning up agents..."
-    kill_all_agents
-    cancel_all_tasks
-}
-
-# Trap for cleanup on exit
-trap cleanup_agents EXIT INT TERM

package/lib/ui.sh

@@ -4,9 +4,11 @@
 
 set -euo pipefail
 
-# Source core for colors
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/core.sh"
+# Source core for colors (use AGENTK_ROOT if set, otherwise compute local path)
+_UI_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [[ -z "${AGENTK_ROOT:-}" ]]; then
+    source "$_UI_SCRIPT_DIR/core.sh"
+fi
 
 # =============================================================================
 # UNICODE CHARACTERS

package/lib/visual.sh

@@ -4,10 +4,12 @@
 
 set -euo pipefail
 
-# Source dependencies
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/core.sh"
-source "$SCRIPT_DIR/ui.sh"
+# Source dependencies (use AGENTK_ROOT if set, otherwise compute local path)
+_VISUAL_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [[ -z "${AGENTK_ROOT:-}" ]]; then
+    source "$_VISUAL_SCRIPT_DIR/core.sh"
+    source "$_VISUAL_SCRIPT_DIR/ui.sh"
+fi
 
 # =============================================================================
 # CONSTANTS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentk8",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Multi-Agent Claude Code Terminal Suite - Orchestrate multiple Claude agents for software development and ML research",
   "keywords": [
     "claude",