loki-mode 5.48.2 → 5.49.1

package/autonomy/run.sh

@@ -667,6 +667,146 @@ log_error() { echo -e "${RED}[ERROR]${NC} $*"; }
 log_step() { echo -e "${CYAN}[STEP]${NC} $*"; }
 log_debug() { [[ "${LOKI_DEBUG:-}" == "true" ]] && echo -e "${CYAN}[DEBUG]${NC} $*" || true; }
 
+#===============================================================================
+# Process Registry (PID Supervisor)
+# Central registry of all spawned child processes for reliable cleanup
+#===============================================================================
+
+PID_REGISTRY_DIR=""
+
+# Initialize the PID registry directory
+init_pid_registry() {
+    PID_REGISTRY_DIR="${TARGET_DIR:-.}/.loki/pids"
+    mkdir -p "$PID_REGISTRY_DIR"
+}
+
+# Parse a field from a JSON registry entry (python3 with shell fallback)
+# Usage: _parse_json_field <file> <field>
+_parse_json_field() {
+    local file="$1" field="$2"
+    if command -v python3 >/dev/null 2>&1; then
+        python3 -c "import json,sys; print(json.load(open(sys.argv[1])).get(sys.argv[2],''))" "$file" "$field" 2>/dev/null
+    else
+        # Shell fallback: extract value for simple flat JSON
+        sed 's/.*"'"$field"'":\s*//' "$file" 2>/dev/null | sed 's/[",}].*//' | head -1
+    fi
+}
+
+# Register a spawned process in the central registry
+# Usage: register_pid <pid> <label> [<extra_info>]
+# Example: register_pid $! "dashboard" "port=57374"
+register_pid() {
+    local pid="$1"
+    # Sanitize label and extra for JSON safety (escape backslash first, then double-quote, strip newlines)
+    local label="${2//\\/\\\\}"
+    label="${label//\"/\\\"}"
+    label="$(printf '%s' "$label" | tr -d '\n\r')"
+    local extra="${3:-}"
+    extra="${extra//\\/\\\\}"
+    extra="${extra//\"/\\\"}"
+    extra="$(printf '%s' "$extra" | tr -d '\n\r')"
+    [ -z "$PID_REGISTRY_DIR" ] && init_pid_registry
+    local entry_file="$PID_REGISTRY_DIR/${pid}.json"
+    cat > "$entry_file" << EOF
+{"pid":$pid,"label":"$label","started":"$(date -u +%Y-%m-%dT%H:%M:%SZ)","ppid":$$,"extra":"$extra"}
+EOF
+}
+
+# Unregister a process from the registry (called on clean shutdown)
+# Usage: unregister_pid <pid>
+unregister_pid() {
+    local pid="$1"
+    [ -z "$PID_REGISTRY_DIR" ] && init_pid_registry
+    rm -f "$PID_REGISTRY_DIR/${pid}.json" 2>/dev/null
+}
+
+# Kill a registered process with SIGTERM -> wait -> SIGKILL escalation
+# Usage: kill_registered_pid <pid>
+kill_registered_pid() {
+    local pid="$1"
+    if kill -0 "$pid" 2>/dev/null; then
+        kill "$pid" 2>/dev/null || true
+        # Wait up to 2 seconds for graceful exit
+        local waited=0
+        while [ $waited -lt 4 ] && kill -0 "$pid" 2>/dev/null; do
+            sleep 0.5
+            waited=$((waited + 1))
+        done
+        # Escalate to SIGKILL if still alive
+        if kill -0 "$pid" 2>/dev/null; then
+            kill -9 "$pid" 2>/dev/null || true
+        fi
+    fi
+    unregister_pid "$pid"
+}
+
+# Scan registry for orphaned processes and kill them
+# Called on startup and by `loki cleanup`
+# Returns: number of orphans killed
+cleanup_orphan_pids() {
+    [ -z "$PID_REGISTRY_DIR" ] && init_pid_registry
+    local orphan_count=0
+
+    if [ ! -d "$PID_REGISTRY_DIR" ]; then
+        echo "0"
+        return 0
+    fi
+
+    for entry_file in "$PID_REGISTRY_DIR"/*.json; do
+        [ -f "$entry_file" ] || continue
+        local pid
+        pid=$(basename "$entry_file" .json)
+
+        # Skip non-numeric filenames
+        case "$pid" in
+            ''|*[!0-9]*) continue ;;
+        esac
+
+        if kill -0 "$pid" 2>/dev/null; then
+            # Process is alive -- check if its parent session is dead
+            local ppid_val=""
+            ppid_val=$(_parse_json_field "$entry_file" "ppid") || true
+
+            # Validate ppid_val is numeric before using with kill
+            case "$ppid_val" in ''|*[!0-9]*) ppid_val="" ;; esac
+            if [ -n "$ppid_val" ] && [ "$ppid_val" != "$$" ]; then
+                if ! kill -0 "$ppid_val" 2>/dev/null; then
+                    # Parent is dead -- this is an orphan
+                    local label=""
+                    label=$(_parse_json_field "$entry_file" "label") || label="unknown"
+                    log_warn "Killing orphaned process: PID=$pid label=$label (parent $ppid_val is dead)" >&2
+                    kill_registered_pid "$pid"
+                    orphan_count=$((orphan_count + 1))
+                fi
+            fi
+        else
+            # Process is dead -- clean up stale registry entry
+            rm -f "$entry_file" 2>/dev/null
+        fi
+    done
+
+    echo "$orphan_count"
+}
+
+# Kill ALL registered processes (used during full shutdown)
+kill_all_registered() {
+    [ -z "$PID_REGISTRY_DIR" ] && init_pid_registry
+
+    if [ ! -d "$PID_REGISTRY_DIR" ]; then
+        return 0
+    fi
+
+    for entry_file in "$PID_REGISTRY_DIR"/*.json; do
+        [ -f "$entry_file" ] || continue
+        local pid
+        pid=$(basename "$entry_file" .json)
+        case "$pid" in
+            ''|*[!0-9]*) continue ;;
+        esac
+        kill_registered_pid "$pid"
+    done
+}
+
 #===============================================================================
 # Event Emission (Dashboard Integration)
 # Writes events to .loki/events.jsonl for dashboard consumption
@@ -1688,6 +1828,7 @@ create_worktree() {
         ) &
         # Capture install PID for cleanup on exit
         WORKTREE_INSTALL_PIDS+=($!)
+        register_pid "$!" "worktree-install" "stream=$stream_name"
 
         log_info "Created worktree: $worktree_path"
         return 0
@@ -1796,6 +1937,7 @@ spawn_worktree_session() {
 
     local pid=$!
     WORKTREE_PIDS[$stream_name]=$pid
+    register_pid "$pid" "worktree-session" "stream=$stream_name"
 
     log_info "Session spawned: $stream_name (PID: $pid)"
     return 0
@@ -2002,6 +2144,7 @@ cleanup_parallel_streams() {
         if kill -0 "$pid" 2>/dev/null; then
             kill "$pid" 2>/dev/null || true
         fi
+        unregister_pid "$pid"
     done
     WORKTREE_INSTALL_PIDS=()
 
@@ -2012,6 +2155,7 @@ cleanup_parallel_streams() {
             log_step "Stopping session: $stream"
             kill "$pid" 2>/dev/null || true
         fi
+        unregister_pid "$pid"
     done
 
     # Wait for all to finish
@@ -2620,8 +2764,8 @@ write_dashboard_state() {
     # Get complexity tier
     local complexity="${DETECTED_COMPLEXITY:-standard}"
 
-    # Get RARV cycle step (approximate based on iteration)
-    local rarv_step=$((ITERATION_COUNT % 4))
+    # Get RARV cycle step from actual phase tracking (falls back to iteration-based)
+    local rarv_step=${RARV_CURRENT_STEP:-$((ITERATION_COUNT % 4))}
     local rarv_stages='["reason", "act", "reflect", "verify"]'
 
     # Get memory system stats (if available)
@@ -2634,9 +2778,9 @@ write_dashboard_state() {
     [ -d ".loki/memory/skills" ] && procedural_count=$(find ".loki/memory/skills" -type f -name "*.json" 2>/dev/null | wc -l | tr -d ' ')
 
     # Get quality gates status (if available)
-    local quality_gates='{"staticAnalysis":"pending","codeReview":"pending","antiSycophancy":"pending","testCoverage":"pending","securityScan":"pending","performance":"pending"}'
+    local quality_gates='null'
     if [ -f ".loki/state/quality-gates.json" ]; then
-        quality_gates=$(cat ".loki/state/quality-gates.json" 2>/dev/null || echo "$quality_gates")
+        quality_gates=$(cat ".loki/state/quality-gates.json" 2>/dev/null || echo 'null')
     fi
 
     # Get Completion Council state (v5.25.0)
@@ -3037,6 +3181,7 @@ start_status_monitor() {
         done
     ) &
     STATUS_MONITOR_PID=$!
+    register_pid "$STATUS_MONITOR_PID" "status-monitor"
 
     log_info "Status monitor started"
     log_info "Monitor progress: ${CYAN}watch -n 2 cat .loki/STATUS.txt${NC}"
@@ -3046,6 +3191,7 @@ stop_status_monitor() {
     if [ -n "$STATUS_MONITOR_PID" ]; then
         kill "$STATUS_MONITOR_PID" 2>/dev/null || true
         wait "$STATUS_MONITOR_PID" 2>/dev/null || true
+        unregister_pid "$STATUS_MONITOR_PID"
     fi
     stop_resource_monitor
 }
@@ -3621,6 +3767,7 @@ start_resource_monitor() {
         done
     ) &
     RESOURCE_MONITOR_PID=$!
+    register_pid "$RESOURCE_MONITOR_PID" "resource-monitor"
 
     log_info "Resource monitor started (CPU threshold: ${RESOURCE_CPU_THRESHOLD}%, Memory threshold: ${RESOURCE_MEM_THRESHOLD}%)"
     log_info "Check status: ${CYAN}cat .loki/state/resources.json${NC}"
@@ -3630,6 +3777,7 @@ stop_resource_monitor() {
     if [ -n "$RESOURCE_MONITOR_PID" ]; then
         kill "$RESOURCE_MONITOR_PID" 2>/dev/null || true
         wait "$RESOURCE_MONITOR_PID" 2>/dev/null || true
+        unregister_pid "$RESOURCE_MONITOR_PID"
     fi
 }
 
@@ -4720,12 +4868,14 @@ BUILD_PROMPT
             esac
         ) &
         pids+=($!)
+        register_pid "$!" "code-reviewer" "name=$reviewer_name"
     done
 
     # Wait for all reviewers to complete
     log_info "Waiting for $reviewer_count reviewers to complete (blind review)..."
     for pid in "${pids[@]}"; do
         wait "$pid" || true
+        unregister_pid "$pid"
     done
 
     log_info "All reviewers complete. Aggregating verdicts..."
@@ -5191,6 +5341,7 @@ start_dashboard() {
     LOKI_TLS_CERT="${LOKI_TLS_CERT:-}" LOKI_TLS_KEY="${LOKI_TLS_KEY:-}" \
         LOKI_SKILL_DIR="${skill_dir}" PYTHONPATH="${skill_dir}" nohup "$python_cmd" -m dashboard.server > "$log_file" 2>&1 &
     DASHBOARD_PID=$!
+    register_pid "$DASHBOARD_PID" "dashboard" "port=${DASHBOARD_PORT:-57374}"
 
     # Save PID for later cleanup
     mkdir -p .loki/dashboard
@@ -5224,6 +5375,7 @@ stop_dashboard() {
     if [ -n "$DASHBOARD_PID" ]; then
         kill "$DASHBOARD_PID" 2>/dev/null || true
         wait "$DASHBOARD_PID" 2>/dev/null || true
+        unregister_pid "$DASHBOARD_PID"
     fi
 
     # Also try PID file
@@ -5231,6 +5383,7 @@ stop_dashboard() {
         local saved_pid=$(cat ".loki/dashboard/dashboard.pid" 2>/dev/null)
         if [ -n "$saved_pid" ]; then
             kill "$saved_pid" 2>/dev/null || true
+            unregister_pid "$saved_pid"
         fi
         rm -f ".loki/dashboard/dashboard.pid"
     fi
@@ -5681,6 +5834,132 @@ load_handoff_context() {
     fi
 }
 
+# Write structured handoff document (v5.49.0)
+# Produces both JSON (machine-readable) and markdown (human-readable) handoffs
+# Called at end of session or before context clear
+write_structured_handoff() {
+    local reason="${1:-session_end}"
+    local handoff_dir=".loki/memory/handoffs"
+    mkdir -p "$handoff_dir"
+
+    local timestamp
+    timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    local file_ts
+    file_ts=$(date +"%Y%m%d-%H%M%S")
+    local handoff_json="$handoff_dir/${file_ts}.json"
+    local handoff_md="$handoff_dir/${file_ts}.md"
+
+    # Gather structured data
+    local files_modified=""
+    files_modified=$(git diff --name-only HEAD 2>/dev/null | head -20 | tr '\n' ',' | sed 's/,$//')
+    local recent_commits=""
+    recent_commits=$(git log --oneline -5 2>/dev/null | tr '\n' '|' | sed 's/|$//')
+    local pending_tasks=0
+    local completed_tasks=0
+    if [ -f ".loki/queue/pending.json" ]; then
+        pending_tasks=$(_QF=".loki/queue/pending.json" python3 -c "import json,os;print(len(json.load(open(os.environ['_QF']))))" 2>/dev/null || echo "0")
+    fi
+    if [ -f ".loki/queue/completed.json" ]; then
+        completed_tasks=$(_QF=".loki/queue/completed.json" python3 -c "import json,os;print(len(json.load(open(os.environ['_QF']))))" 2>/dev/null || echo "0")
+    fi
+
+    # Write JSON handoff
+    _H_TS="$timestamp" \
+    _H_REASON="$reason" \
+    _H_ITER="${ITERATION_COUNT:-0}" \
+    _H_FILES="$files_modified" \
+    _H_COMMITS="$recent_commits" \
+    _H_PENDING="$pending_tasks" \
+    _H_COMPLETED="$completed_tasks" \
+    _H_JSON="$handoff_json" \
+    python3 -c "
+import json, os
+handoff = {
+    'schema_version': '1.0.0',
+    'timestamp': os.environ['_H_TS'],
+    'reason': os.environ['_H_REASON'],
+    'iteration': int(os.environ['_H_ITER']),
+    'files_modified': [f for f in os.environ['_H_FILES'].split(',') if f],
+    'recent_commits': [c for c in os.environ['_H_COMMITS'].split('|') if c],
+    'task_status': {
+        'pending': int(os.environ['_H_PENDING']),
+        'completed': int(os.environ['_H_COMPLETED'])
+    },
+    'open_questions': [],
+    'key_decisions': [],
+    'blockers': []
+}
+with open(os.environ['_H_JSON'], 'w') as f:
+    json.dump(handoff, f, indent=2)
+" 2>/dev/null || log_warn "Failed to write structured handoff JSON"
+
+    # Write markdown companion
+    cat > "$handoff_md" << HANDOFF_EOF
+# Session Handoff - $timestamp
+
+**Reason:** $reason
+**Iteration:** ${ITERATION_COUNT:-0}
+
+## Files Modified
+$files_modified
+
+## Recent Commits
+$(git log --oneline -5 2>/dev/null || echo "none")
+
+## Task Status
+- Pending: $pending_tasks
+- Completed: $completed_tasks
+
+## Notes
+Session handoff generated automatically.
+HANDOFF_EOF
+
+    log_info "Structured handoff written to $handoff_json"
+}
+
+# Load recent handoffs for context (reads both JSON and markdown)
+load_handoff_context() {
+    local handoff_content=""
+
+    # Prefer JSON handoffs (structured, v5.49.0+)
+    local recent_json
+    recent_json=$(find .loki/memory/handoffs -name "*.json" -mtime -1 2>/dev/null | sort -r | head -1)
+
+    if [ -n "$recent_json" ] && [ -f "$recent_json" ]; then
+        handoff_content=$(_HF="$recent_json" python3 -c "
+import json, os
+try:
+    h = json.load(open(os.environ['_HF']))
+    parts = []
+    parts.append(f\"Handoff from {h.get('timestamp','unknown')} (reason: {h.get('reason','unknown')})\")
+    parts.append(f\"Iteration: {h.get('iteration',0)}\")
+    files = h.get('files_modified', [])
+    if files:
+        parts.append(f\"Modified files: {', '.join(files[:10])}\")
+    tasks = h.get('task_status', {})
+    parts.append(f\"Tasks - pending: {tasks.get('pending',0)}, completed: {tasks.get('completed',0)}\")
+    for q in h.get('open_questions', []):
+        parts.append(f\"Open question: {q}\")
+    for b in h.get('blockers', []):
+        parts.append(f\"Blocker: {b}\")
+    print(' | '.join(parts))
+except Exception as e:
+    print(f'Error reading handoff: {e}')
+" 2>/dev/null)
+        echo "$handoff_content"
+        return
+    fi
+
+    # Fallback to markdown handoffs (pre-v5.49.0)
+    local recent_handoff
+    recent_handoff=$(find .loki/memory/handoffs -name "*.md" -mtime -1 2>/dev/null | sort -r | head -1)
+
+    if [ -n "$recent_handoff" ] && [ -f "$recent_handoff" ]; then
+        handoff_content=$(cat "$recent_handoff" | head -80)
+        echo "$handoff_content"
+    fi
+}
+
 # Load relevant learnings
 load_learnings_context() {
     local learnings=""
@@ -6995,6 +7274,7 @@ cleanup() {
         fi
         stop_dashboard
         stop_status_monitor
+        kill_all_registered
         rm -f "$loki_dir/loki.pid" 2>/dev/null
         if [ -f "$loki_dir/session.json" ]; then
             _LOKI_SESSION_FILE="$loki_dir/session.json" python3 -c "
@@ -7022,6 +7302,7 @@ except (json.JSONDecodeError, OSError): pass
         fi
         stop_dashboard
         stop_status_monitor
+        kill_all_registered
         rm -f .loki/loki.pid .loki/PAUSE 2>/dev/null
         # Mark session.json as stopped
         if [ -f ".loki/session.json" ]; then
@@ -7209,6 +7490,7 @@ main() {
         LOKI_RUNNING_FROM_TEMP='' nohup "$original_script" "${cmd_args[@]}" > "$log_file" 2>&1 &
         local bg_pid=$!
         echo "$bg_pid" > "$pid_file"
+        register_pid "$bg_pid" "background-session" "log=$log_file"
 
         echo ""
         echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
@@ -7331,6 +7613,14 @@ main() {
     # Write PID file for ALL modes (foreground + background)
     echo "$$" > "$pid_file"
 
+    # Initialize PID registry and clean up orphans from previous sessions
+    init_pid_registry
+    local orphan_count
+    orphan_count=$(cleanup_orphan_pids)
+    if [ "$orphan_count" -gt 0 ]; then
+        log_warn "Killed $orphan_count orphaned process(es) from previous session"
+    fi
+
     # Copy skill files to .loki/skills/ - makes CLI self-contained
     # No need to install Claude Code skill separately
     copy_skill_files
@@ -7410,10 +7700,12 @@ main() {
             run_autonomous "$PRD_PATH"
         ) &
         local main_pid=$!
+        register_pid "$main_pid" "parallel-main" ""
 
         # Run parallel orchestrator
         run_parallel_orchestrator &
         local orchestrator_pid=$!
+        register_pid "$orchestrator_pid" "parallel-orchestrator" ""
 
         # Wait for main session (orchestrator continues watching)
         wait $main_pid || result=$?
@@ -7489,6 +7781,9 @@ main() {
             --context "{\"provider\":\"${PROVIDER_NAME:-claude}\",\"iterations\":$ITERATION_COUNT,\"exit_code\":$result}"
     fi
 
+    # Write structured handoff for future sessions (v5.49.0)
+    write_structured_handoff "session_end_result_${result}" 2>/dev/null || true
+
     # Create PR from agent branch if branch protection was enabled
     create_session_pr
     audit_agent_action "session_stop" "Session ended" "result=$result,iterations=$ITERATION_COUNT"

package/autonomy/sandbox.sh

@@ -843,6 +843,15 @@ start_sandbox() {
         docker_args+=("--volume" "$PROJECT_DIR:/workspace:rw")
     fi
 
+    # Config self-protection: mount critical .loki/ paths as read-only
+    # Prevents agents from corrupting council state, config, or audit trail
+    if [[ -d "$PROJECT_DIR/.loki/council" ]]; then
+        docker_args+=("--volume" "$PROJECT_DIR/.loki/council:/workspace/.loki/council:ro")
+    fi
+    if [[ -f "$PROJECT_DIR/.loki/config.yaml" ]]; then
+        docker_args+=("--volume" "$PROJECT_DIR/.loki/config.yaml:/workspace/.loki/config.yaml:ro")
+    fi
+
     # Mount git config (read-only) - mount to /home/loki since container runs as user loki
     if [[ -f "$HOME/.gitconfig" ]]; then
         docker_args+=("--volume" "$HOME/.gitconfig:/home/loki/.gitconfig:ro")

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "5.48.2"
+__version__ = "5.49.1"
 
 # Expose the control app for easy import
 try:

package/dashboard/server.py

@@ -404,7 +404,20 @@ async def get_status() -> StatusResponse:
             iteration = state.get("iteration", 0)
             complexity = state.get("complexity", "standard")
             mode = state.get("mode", "")
-            running_agents = len(state.get("agents", []))
+            # Count only agents with alive PIDs (not raw array length)
+            agents_list = state.get("agents", [])
+            running_agents = 0
+            for agent in agents_list:
+                agent_pid = agent.get("pid")
+                if agent_pid:
+                    try:
+                        os.kill(int(agent_pid), 0)
+                        running_agents += 1
+                    except (OSError, ValueError, TypeError):
+                        pass
+                else:
+                    # No PID field -- count as running (legacy data)
+                    running_agents += 1
 
             tasks = state.get("tasks", {})
             pending_tasks = len(tasks.get("pending", []))
@@ -3194,6 +3207,31 @@ async def get_process_health(token: Optional[dict] = Depends(auth.get_current_to
         except Exception:
             pass
 
+    # PID registry (central process supervisor)
+    pids_dir = loki_dir / "pids"
+    registered: list[dict[str, Any]] = []
+    if pids_dir.exists():
+        for entry_file in sorted(pids_dir.glob("*.json")):
+            try:
+                pid_str = entry_file.stem
+                pid = int(pid_str)
+                entry = json.loads(entry_file.read_text())
+                try:
+                    os.kill(pid, 0)
+                    status = "alive"
+                except OSError:
+                    status = "dead"
+                registered.append({
+                    "pid": pid,
+                    "label": entry.get("label", "unknown"),
+                    "started": entry.get("started", ""),
+                    "ppid": entry.get("ppid"),
+                    "status": status,
+                })
+            except (ValueError, json.JSONDecodeError, OSError):
+                continue
+    result["registered_processes"] = registered
+
     watchdog_enabled = os.environ.get("LOKI_WATCHDOG", "false").lower() == "true"
     result["watchdog_enabled"] = watchdog_enabled
 

package/docs/COMPARISON.md

@@ -12,7 +12,7 @@
 | Feature | **Loki Mode** | **Zencoder** | **Devin** | **OpenAI Codex** | **Cursor** | **Claude Code** | **Kiro** | **Antigravity** | **Amazon Q** | **OpenCode** |
 |---------|--------------|--------------|-----------|-----------------|------------|-----------------|----------|-----------------|--------------|--------------|
 | **Type** | Skill/Framework | Enterprise Platform | Standalone Agent | Cloud Agent | AI IDE | CLI Agent | AI IDE | AI IDE | Cloud Agent | AI IDE (OSS) |
-| **Autonomy Level** | Full (zero human) | High | Full | High | Medium-High | High | High | High | High | High |
+| **Autonomy Level** | High (minimal human) | High | Full | High | Medium-High | High | High | High | High | High |
 | **Max Runtime** | Unlimited | Async/Scheduled | Hours | Per-task | Session | Session | Days | Async | Per-task | Session |
 | **Pricing** | Free (OSS) | Enterprise | $20/mo | ChatGPT Plus | $20/mo | API costs | Free preview | Free preview | $19/mo | Free (OSS) |
 | **Open Source** | Yes | No | No | No | No | No | No | No | No | Yes |
@@ -24,7 +24,7 @@
 
 | Feature | **Loki Mode** | **Devin** | **Codex** | **Cursor** | **Kiro** | **Antigravity** | **Amazon Q** | **OpenCode** |
 |---------|--------------|-----------|-----------|------------|----------|-----------------|--------------|--------------|
-| **Multi-Agent** | 41 agents in 7 swarms | Single | Single | Up to 8 parallel | Background | Manager Surface | Multiple types | 4 built-in |
+| **Multi-Agent** | 41 agents in 8 swarms | Single | Single | Up to 8 parallel | Background | Manager Surface | Multiple types | 4 built-in |
 | **Orchestration** | Full orchestrator | N/A | N/A | Git worktree | Hooks | Manager view | Workflow | Subagents |
 | **Parallel Exec** | 10+ Haiku, 4 impl (worktree) | No | No | 8 max | Yes | Yes | Yes | Yes |
 | **Agent Swarms** | Eng, Ops, Business, Data, Product, Growth, Review | N/A | N/A | N/A | N/A | N/A | 3 types | N/A |
@@ -180,9 +180,9 @@
 
 1. **Quality Control**: 7 explicit gates + blind review + devil's advocate vs built-in loops
 2. **Memory System**: 3-tier (episodic/semantic/procedural) with cross-project learning
-3. **Agent Specialization**: 41 pre-defined specialized agents across 7 swarms
+3. **Agent Specialization**: 41 pre-defined specialized agents across 8 swarms
 4. **Anti-Sycophancy**: CONSENSAGENT patterns prevent reviewer groupthink
-5. **Autonomy Design**: Zero human intervention from PRD to production
+5. **Autonomy Design**: Minimal human intervention from PRD to production
 6. **Research Foundation**: 10+ academic papers integrated vs proprietary
 
 ### Where Zencoder EXCEEDS Loki Mode
@@ -203,13 +203,13 @@
 |---------|--------------|---------|-----------------|------------|-----------------|---------------------|----------------|
 | **Stars** | 594 | 11,903 | 35K+ | 26K+ | 13.7K | N/A | N/A |
 | **npm/wk** | 6.1K | 21.4K | N/A | N/A | N/A | N/A | N/A |
-| **Agents** | 41 in 7 swarms | 11 agents | Fresh per task | 108 agents | Swarm-based | 32 agents | N/A |
+| **Agents** | 41 in 8 swarms | 11 agents | Fresh per task | 108 agents | Swarm-based | 32 agents | N/A |
 | **Skills** | Progressive disclosure | 6 slash commands | N/A | 129 skills | N/A | 35 skills | Memory focus |
 | **Multi-Provider** | Yes (Claude/Codex/Gemini) | 3 CLIs (separate) | No | No | No | No | No |
 | **Memory System** | 3-tier (episodic/semantic/procedural) | None | N/A | N/A | Hybrid | N/A | SQLite+FTS5 |
 | **Quality Gates** | 7 gates + Completion Council | User verify only | Two-Stage Review | N/A | Consensus | Tiered | N/A |
 | **Context Mgmt** | Standard | Fresh per task (core innovation) | Fresh per task | N/A | N/A | N/A | Progressive |
-| **Autonomy** | Full (zero human) | Semi (checkpoints) | Human-guided | Human-guided | Orchestrated | Human-guided | N/A |
+| **Autonomy** | High (minimal human) | Semi (checkpoints) | Human-guided | Human-guided | Orchestrated | Human-guided | N/A |
 
 ### What Loki Mode LACKS (Honest Assessment)
 
@@ -236,7 +236,7 @@ These are patterns from competing projects that are **practically and scientific
 | **Constitutional AI Integration** | Principles-based self-critique from Anthropic research | None have this |
 | **Anti-Sycophancy (CONSENSAGENT)** | Blind review + devil's advocate prevents groupthink | None have this |
 | **Provider Abstraction Layer** | Clean degradation from full-featured to sequential-only | Claude-only projects can't degrade |
-| **41 Specialized Agents** | Purpose-built agents in 7 swarms vs generic | agents (108) has more but less organized |
+| **41 Specialized Agents** | Purpose-built agents in 8 swarms vs generic | agents (108) has more but less organized |
 | **Research Foundation** | 10+ academic papers integrated with citations | Most have no research backing |
 
 ### Superpowers Deep-Dive (35K+ Stars)
@@ -342,7 +342,7 @@ Tiered agent architecture with explicit escalation:
 
 | Agent | Killer Feature |
 |-------|---------------|
-| **Loki Mode** | Zero-human-intervention full SDLC, 41 agents in 7 swarms, Constitutional AI, anti-sycophancy, cross-project learning, code transformation, property-based testing |
+| **Loki Mode** | Minimal-human-intervention full SDLC, 41 agents in 8 swarms, Constitutional AI, anti-sycophancy, cross-project learning, code transformation, property-based testing |
 | **Devin** | Full software engineer persona, Slack integration, 67% PR merge rate |
 | **OpenAI Codex** | Skills marketplace, $skill-creator, GPT-5.2-Codex, secure sandbox |
 | **Cursor** | 8 parallel agents, BugBot, Memories, $10B valuation, Composer model (250 tok/s) |
@@ -357,8 +357,8 @@ Tiered agent architecture with explicit escalation:
 
 | Dimension | Loki Mode Advantage |
 |-----------|-------------------|
-| **Autonomy** | Only agent designed for TRUE zero human intervention |
-| **Multi-Agent** | 41 specialized agents in 7 swarms vs 1-8 in competitors |
+| **Autonomy** | Designed for high autonomy with minimal human intervention |
+| **Multi-Agent** | 41 specialized agents in 8 swarms vs 1-8 in competitors |
 | **Quality** | 7 gates + blind review + devil's advocate + property-based testing |
 | **Research** | 10+ academic papers integrated vs proprietary/undisclosed |
 | **Anti-Sycophancy** | Only agent with CONSENSAGENT-based blind review |

package/docs/COMPETITIVE-ANALYSIS.md

@@ -37,9 +37,9 @@ GSD is the closest competitor -- a context engineering system that spawns fresh
 |---------|-----------|-------------|---------|--------|--------------|-------|
 | **GitHub Stars** | 594 | 13,700 | 62,400 | 25,000+ | N/A (Commercial) | N/A (Commercial) |
 | **Agent Count** | 41 types | 64+ agents | 5 roles | Unlimited | 8 parallel | 1 autonomous |
-| **Parallel Execution** | Yes (100+) | Yes (swarms) | Sequential | Yes (crews) | Yes (8 worktrees) | Yes (fleet) |
-| **Published Benchmarks** | **98.78% HumanEval (multi-agent)** | None | 85.9-87.7% HumanEval | None | ~250 tok/s | 15% complex tasks |
-| **SWE-bench Score** | **99.67% patch gen (299/300)** | Unknown | Unknown | Unknown | Unknown | 15% complex |
+| **Parallel Execution** | Yes (multi-agent) | Yes (swarms) | Sequential | Yes (crews) | Yes (8 worktrees) | Yes (fleet) |
+| **Published Benchmarks** | 98.78% HumanEval (self-reported, max 3 retries) | None | 85.9-87.7% HumanEval | None | ~250 tok/s | 15% complex tasks |
+| **SWE-bench Score** | 99.67% patch gen (unevaluated, 299/300) | Unknown | Unknown | Unknown | Unknown | 15% complex |
 | **Full SDLC** | Yes (8 phases) | Yes | Partial | Partial | No | Partial |
 | **Business Ops** | **Yes (8 agents)** | No | No | No | No | No |
 | **Enterprise Security** | `--dangerously-skip-permissions` | MCP sandboxed | Sandboxed | Audit logs, RBAC | Staged autonomy | Sandboxed |