claude-symphony 0.2.9 → 0.2.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-symphony",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Multi-AI Orchestration Framework - Create new projects with 10-stage development workflow",
   "type": "module",
   "bin": {

package/scripts/memory-relay/orchestrator/claude-wrapper.sh

@@ -124,13 +124,24 @@ for arg in "$@"; do
     fi
 done
 
+# Get configured threshold
+get_threshold() {
+    local config_file="${HOME}/.claude/memory-relay/config.json"
+    if [[ -f "${config_file}" ]] && command -v jq &> /dev/null; then
+        jq -r '.threshold.trigger_percentage // 50' "${config_file}" 2>/dev/null || echo "50"
+    else
+        echo "50"
+    fi
+}
+
 # Display relay status banner
 show_relay_banner() {
+    local threshold=$(get_threshold)
     echo ""
     echo -e "${CYAN}+============================================================+${NC}"
     echo -e "${CYAN}|${NC}           ${GREEN}Claude Symphony - Encore Mode${NC}                  ${CYAN}|${NC}"
     echo -e "${CYAN}+============================================================+${NC}"
-    echo -e "${CYAN}|${NC}  Automatic session handoff at 50% context               ${CYAN}|${NC}"
+    printf "${CYAN}|${NC}  Automatic session handoff at %s%% context               ${CYAN}|${NC}\n" "${threshold}"
     echo -e "${CYAN}|${NC}  Claude never stops - your workflow continues forever   ${CYAN}|${NC}"
     echo -e "${CYAN}+============================================================+${NC}"
     echo ""
@@ -154,8 +165,9 @@ if [[ -n "${HANDOFF_FILE}" ]] && [[ -f "${HANDOFF_FILE}" ]]; then
 
     show_relay_banner
 
-    # Start Claude with instruction to read handoff
-    exec $(get_claude_cmd) --resume "${HANDOFF_FILE}" 2>/dev/null || exec $(get_claude_cmd)
+    # Start Claude with system prompt to read handoff file and continue work
+    # Using --append-system-prompt to stay in interactive mode (not -p which exits after response)
+    exec $(get_claude_cmd) --append-system-prompt "IMPORTANT: A handoff file has been created at ${HANDOFF_FILE}. You MUST read this file immediately using the Read tool and continue the previous work described within it. This is a session continuation - start by reading the handoff file."
 else
     log_relay "Starting fresh Claude session with relay support"
     show_relay_banner

package/scripts/memory-relay/orchestrator/orchestrator.sh

@@ -90,23 +90,59 @@ check_running() {
     return 1
 }
 
-# Send ACK back to Claude session
-send_ack() {
-    local source_pane="$1"
-    local new_pane="$2"
-    local ack_message="RELAY_ACK:${new_pane}"
+# Wait for /clear to complete
+wait_for_clear_complete() {
+    local pane_id="$1"
+    local timeout="${2:-15}"
+    local elapsed=0
+
+    log "INFO" "Waiting for /clear to complete in pane ${pane_id} (timeout: ${timeout}s)"
+
+    while [[ ${elapsed} -lt ${timeout} ]]; do
+        # Capture last few lines of pane output
+        local output
+        output=$(tmux capture-pane -t "${pane_id}" -p -S -5 2>/dev/null || echo "")
+
+        # Check for Claude prompt ready state (ends with > or is empty/minimal)
+        local trimmed
+        trimmed=$(echo "${output}" | tr -d '[:space:]')
+
+        if [[ -z "${trimmed}" ]] || [[ "${output}" =~ \>$ ]]; then
+            sleep 0.5  # Small stabilization delay
+            log "INFO" "/clear completed, Claude is ready for input"
+            return 0
+        fi
+
+        sleep 0.5
+        ((elapsed++))
+    done
 
-    log "INFO" "Sending ACK to pane ${source_pane}: ${ack_message}"
+    log "ERROR" "Timeout waiting for /clear to complete after ${timeout}s"
+    return 1
+}
 
-    if tmux send-keys -t "${source_pane}" "# ${ack_message}" Enter 2>/dev/null; then
-        log "INFO" "ACK sent successfully"
+# Send prompt to pane
+send_prompt_to_pane() {
+    local pane_id="$1"
+    local prompt="$2"
+
+    log "INFO" "Sending handoff prompt to pane ${pane_id}"
+
+    if tmux send-keys -t "${pane_id}" "${prompt}" Enter 2>/dev/null; then
+        log "INFO" "Handoff prompt sent successfully"
         return 0
     else
-        log "WARN" "Failed to send ACK to pane ${source_pane}"
+        log "ERROR" "Failed to send prompt to pane ${pane_id}"
         return 1
     fi
 }
 
+# Build continuation prompt
+build_continuation_prompt() {
+    local handoff_path="$1"
+    echo "${handoff_path} 파일을 읽고 이어서 작업을 진행해주세요."
+}
+
 # Handle relay signal
 handle_relay_signal() {
     local signal="$1"
@@ -115,43 +151,43 @@ handle_relay_signal() {
     # Parse signal: RELAY_READY:handoff_path:source_pane
     if [[ "${signal}" =~ ^RELAY_READY:(.+):(.+)$ ]]; then
         local handoff_path="${BASH_REMATCH[1]}"
-        local source_pane="${BASH_REMATCH[2]}"
+        local pane_id="${BASH_REMATCH[2]}"
 
         log "INFO" "Processing relay request"
         log "INFO" "  Handoff path: ${handoff_path}"
-        log "INFO" "  Source pane: ${source_pane}"
+        log "INFO" "  Pane: ${pane_id}"
 
         if [[ ! -f "${handoff_path}" ]]; then
             log "ERROR" "Handoff file not found: ${handoff_path}"
             return 1
         fi
 
-        local work_dir=$(dirname "${handoff_path}")
-
-        log "INFO" "Creating new tmux pane for Claude session"
-
-        local new_pane
-        new_pane=$(tmux split-window -h -P -F "#{pane_id}" \
-            -c "${work_dir}" \
-            "${ORCHESTRATOR_DIR}/claude-wrapper.sh '${handoff_path}'" 2>&1)
+        # Step 1: Send /clear command to current pane
+        log "INFO" "Sending /clear to pane ${pane_id}"
+        if ! tmux send-keys -t "${pane_id}" "/clear" Enter 2>/dev/null; then
+            log "ERROR" "Failed to send /clear to pane ${pane_id}"
+            return 1
+        fi
 
-        if [[ $? -eq 0 ]] && [[ -n "${new_pane}" ]]; then
-            log "INFO" "New pane created: ${new_pane}"
-            sleep 2
+        # Step 2: Wait for /clear to complete
+        if ! wait_for_clear_complete "${pane_id}" 15; then
+            log "ERROR" "Clear did not complete in time"
+            return 1
+        fi
 
-            if tmux list-panes -F "#{pane_id}" | grep -q "${new_pane}"; then
-                log "INFO" "New Claude session started successfully"
-                send_ack "${source_pane}" "${new_pane}"
-                archive_handoff "${handoff_path}"
-                return 0
-            else
-                log "ERROR" "New pane ${new_pane} not found after creation"
-                return 1
-            fi
-        else
-            log "ERROR" "Failed to create new pane: ${new_pane}"
+        # Step 3: Send handoff prompt
+        local prompt
+        prompt=$(build_continuation_prompt "${handoff_path}")
+        if ! send_prompt_to_pane "${pane_id}" "${prompt}"; then
+            log "ERROR" "Failed to send handoff prompt"
             return 1
         fi
+
+        log "INFO" "Session handoff complete via /clear injection"
+
+        # Archive the handoff file
+        archive_handoff "${handoff_path}"
+        return 0
     else
         log "WARN" "Invalid signal format: ${signal}"
         return 1

package/template/.claude/commands/threshold.md

@@ -0,0 +1,161 @@
+# /threshold - Context Reset Threshold
+
+Set the context percentage threshold for automatic session relay.
+
+## Usage
+```
+/threshold              # Show current threshold
+/threshold <percent>    # Set threshold (e.g., /threshold 80)
+/threshold reset        # Reset to default (50%)
+```
+
+## Actions
+
+### Show Current Threshold (`/threshold`)
+
+Read the config file and display current threshold settings:
+
+```bash
+CONFIG_FILE="$HOME/.claude/memory-relay/config.json"
+if [ -f "$CONFIG_FILE" ]; then
+    TRIGGER=$(jq -r '.threshold.trigger_percentage // 50' "$CONFIG_FILE")
+    WARNING=$(jq -r '.threshold.warning_percentage // 60' "$CONFIG_FILE")
+    echo ""
+    echo "Current Context Threshold Settings:"
+    echo "  Trigger (relay/compact): ${TRIGGER}%"
+    echo "  Warning display: ${WARNING}%"
+    echo ""
+    echo "Session will relay when context drops to ${TRIGGER}% or below."
+else
+    echo "Config file not found. Using defaults (trigger: 50%, warning: 60%)"
+fi
+```
+
+### Set Threshold (`/threshold <percent>`)
+
+1. Validate percent is between 10-90
+2. Update `~/.claude/memory-relay/config.json`:
+   - Set `threshold.trigger_percentage` to the specified value
+   - Set `threshold.warning_percentage` to value + 10 (capped at 90)
+
+```bash
+PERCENT=$1  # e.g., 80
+CONFIG_FILE="$HOME/.claude/memory-relay/config.json"
+
+# Validate range
+if [ "$PERCENT" -lt 10 ] || [ "$PERCENT" -gt 90 ]; then
+    echo "Error: Threshold must be between 10 and 90"
+    exit 1
+fi
+
+# Calculate warning threshold (trigger + 10, max 90)
+WARNING=$((PERCENT + 10))
+if [ "$WARNING" -gt 90 ]; then
+    WARNING=90
+fi
+
+# Ensure directory exists
+mkdir -p "$(dirname "$CONFIG_FILE")"
+
+# Update config (or create if not exists)
+if [ -f "$CONFIG_FILE" ]; then
+    jq --argjson trigger "$PERCENT" --argjson warning "$WARNING" \
+        '.threshold.trigger_percentage = $trigger | .threshold.warning_percentage = $warning' \
+        "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
+else
+    cat > "$CONFIG_FILE" << EOF
+{
+  "threshold": {
+    "trigger_percentage": $PERCENT,
+    "warning_percentage": $WARNING,
+    "cooldown_seconds": 300
+  }
+}
+EOF
+fi
+
+echo ""
+echo "Context threshold updated:"
+echo "  Trigger: ${PERCENT}%"
+echo "  Warning: ${WARNING}%"
+echo ""
+echo "Session will relay when context drops to ${PERCENT}% or below."
+```
+
+### Reset to Default (`/threshold reset`)
+
+Reset trigger_percentage to default value (50%):
+
+```bash
+CONFIG_FILE="$HOME/.claude/memory-relay/config.json"
+
+if [ -f "$CONFIG_FILE" ]; then
+    jq '.threshold.trigger_percentage = 50 | .threshold.warning_percentage = 60' \
+        "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
+fi
+
+echo ""
+echo "Context threshold reset to defaults:"
+echo "  Trigger: 50%"
+echo "  Warning: 60%"
+```
+
+## Output Examples
+
+### Show Current
+```
+/threshold
+
+Current Context Threshold Settings:
+  Trigger (relay/compact): 50%
+  Warning display: 60%
+
+Session will relay when context drops to 50% or below.
+```
+
+### Set Threshold
+```
+/threshold 80
+
+Context threshold updated:
+  Trigger: 80%
+  Warning: 90%
+
+Session will relay when context drops to 80% or below.
+```
+
+### Reset
+```
+/threshold reset
+
+Context threshold reset to defaults:
+  Trigger: 50%
+  Warning: 60%
+```
+
+## Configuration File
+
+Location: `~/.claude/memory-relay/config.json`
+
+```json
+{
+  "threshold": {
+    "trigger_percentage": 50,
+    "warning_percentage": 60,
+    "cooldown_seconds": 300
+  }
+}
+```
+
+## Notes
+
+- This is a **global setting** (applies to all projects)
+- Valid range: 10-90%
+- Higher threshold = earlier relay (more aggressive context management)
+- Lower threshold = later relay (use more context before handoff)
+- Recommended: 50% (default) for most workflows, 70-80% for complex tasks
+
+## Related Commands
+
+- `/context` - Check current context state
+- `/handoff` - Generate handoff document manually

package/template/.claude/hooks/statusline.sh

@@ -11,10 +11,25 @@ PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 STATE_FILE="$PROJECT_ROOT/state/context/auto-trigger.json"
 PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
 CONTEXT_DIR="$PROJECT_ROOT/state/context"
+CONFIG_FILE="$HOME/.claude/memory-relay/config.json"
 
 # Ensure context directory
 mkdir -p "$CONTEXT_DIR"
 
+# Read thresholds from config (with defaults)
+if [ -f "$CONFIG_FILE" ] && command -v jq &> /dev/null; then
+    THRESHOLD_TRIGGER=$(jq -r '.threshold.trigger_percentage // 50' "$CONFIG_FILE" 2>/dev/null || echo "50")
+    THRESHOLD_WARNING=$(jq -r '.threshold.warning_percentage // 60' "$CONFIG_FILE" 2>/dev/null || echo "60")
+else
+    THRESHOLD_TRIGGER=50
+    THRESHOLD_WARNING=60
+fi
+# Critical is always trigger - 10
+THRESHOLD_CRITICAL=$((THRESHOLD_TRIGGER - 10))
+if [ "$THRESHOLD_CRITICAL" -lt 10 ]; then
+    THRESHOLD_CRITICAL=10
+fi
+
 # Read JSON from stdin
 input=$(cat)
 
@@ -41,21 +56,21 @@ fi
 REMAINING_INT=$(printf "%.0f" "$REMAINING" 2>/dev/null || echo "100")
 
 # Determine status and color
-# Thresholds: 60% warning, 50% auto-save, 40% critical
-if [ "$REMAINING_INT" -le 40 ]; then
-    # 40% or below: Critical - recommend /clear
+# Thresholds from config: warning (display), trigger (auto-save), critical (relay)
+if [ "$REMAINING_INT" -le "$THRESHOLD_CRITICAL" ]; then
+    # Critical - recommend /clear or relay
     STATUS_ICON="🔴"
-    STATUS_TEXT="CTX≤40%"
+    STATUS_TEXT="CTX≤${THRESHOLD_CRITICAL}%"
     NEEDS_ACTION="critical"
-elif [ "$REMAINING_INT" -le 50 ]; then
-    # 50% or below: Auto snapshot trigger
+elif [ "$REMAINING_INT" -le "$THRESHOLD_TRIGGER" ]; then
+    # Trigger level - auto snapshot/relay
     STATUS_ICON="⚠️"
-    STATUS_TEXT="CTX≤50%"
+    STATUS_TEXT="CTX≤${THRESHOLD_TRIGGER}%"
     NEEDS_ACTION="warning"
-elif [ "$REMAINING_INT" -le 60 ]; then
-    # 60% or below: Warning display
+elif [ "$REMAINING_INT" -le "$THRESHOLD_WARNING" ]; then
+    # Warning display
     STATUS_ICON="⚡"
-    STATUS_TEXT="CTX≤60%"
+    STATUS_TEXT="CTX≤${THRESHOLD_WARNING}%"
     NEEDS_ACTION="notice"
 else
     # Normal

package/template/.claude/hooks/stop.sh

@@ -12,13 +12,19 @@ TRIGGER_FILE="$PROJECT_ROOT/state/context/auto-trigger.json"
 COOLDOWN_FILE="$PROJECT_ROOT/state/context/.last-compact"
 CONTEXT_DIR="$PROJECT_ROOT/state/context"
 PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+CONFIG_FILE="$HOME/.claude/memory-relay/config.json"
 
 # Memory Relay FIFO paths
 MEMORY_RELAY_FIFO_GLOBAL="$HOME/.claude/memory-relay/orchestrator/signals/relay.fifo"
 MEMORY_RELAY_FIFO_LOCAL="$PROJECT_ROOT/scripts/memory-relay/orchestrator/signals/relay.fifo"
 
-# Cooldown time (seconds) - 5 minutes
+# Read threshold and cooldown from config (with defaults)
+THRESHOLD_TRIGGER=50
 COOLDOWN_SECONDS=300
+if [ -f "$CONFIG_FILE" ] && command -v jq &> /dev/null; then
+    THRESHOLD_TRIGGER=$(jq -r '.threshold.trigger_percentage // 50' "$CONFIG_FILE" 2>/dev/null || echo "50")
+    COOLDOWN_SECONDS=$(jq -r '.threshold.cooldown_seconds // 300' "$CONFIG_FILE" 2>/dev/null || echo "300")
+fi
 
 # Ensure context directory
 mkdir -p "$CONTEXT_DIR"
@@ -44,8 +50,8 @@ fi
 REMAINING=$(jq -r '.remaining // 100' "$TRIGGER_FILE" 2>/dev/null || echo "100")
 LEVEL=$(jq -r '.level // "warning"' "$TRIGGER_FILE" 2>/dev/null || echo "warning")
 
-# Skip if not 50% or below
-if [ "$REMAINING" -gt 50 ]; then
+# Skip if above trigger threshold
+if [ "$REMAINING" -gt "$THRESHOLD_TRIGGER" ]; then
     exit 0
 fi
 

package/template/.claude/settings.json

@@ -124,6 +124,10 @@
     "validate": {
       "description": "Run output validation",
       "file": "commands/validate.md"
+    },
+    "threshold": {
+      "description": "Configure context reset threshold for relay",
+      "file": "commands/threshold.md"
     }
   },
   "skills": {

package/template/CLAUDE.md

@@ -183,6 +183,9 @@ Visualizes context usage, tool activity, and todo progress in the statusline.
 | `/config sprint disable` | Disable sprint mode (single-pass) |
 | `/config sprint status` | Show current iteration settings |
 | `/config sprint count <n>` | Set default sprint count |
+| `/threshold` | Show current context reset threshold |
+| `/threshold <percent>` | Set relay trigger threshold (10-90%) |
+| `/threshold reset` | Reset threshold to default (50%) |
 
 ### Stage Shortcut Commands
 | Command | Stage |