Merge #12 feat/kugetsu-wrapper: add kugetsu session manager with destroy command

- Add destroy subcommand for deleting sessions
- Add destroy --all for fresh start with confirmation
- Add -y flag to skip confirmation prompts
- Add validate_session_id() to reject empty session_ids
- Remove misleading force resume error message
- Update SKILL.md to v1.1 with destroy documentation

skills/kugetsu/SKILL.md

@@ -0,0 +1,148 @@
+---
+name: kugetsu
+description: Session manager for opencode CLI. Use when managing long-running opencode sessions, resuming interrupted work, or tracking session state across disconnects. Features state tracking (used/idle/left), auto-fill last message on resume, and safe locking via confirmation prompts.
+license: MIT
+compatibility: Requires opencode CLI, bash, and filesystem access for session state.
+metadata:
+  author: shoko
+  version: "1.1"
+---
+
+# kugetsu - OpenCode Session Manager
+
+Manages opencode CLI sessions with state tracking and safe resume.
+
+## Installation
+
+### For Human Users
+Run once on a new host:
+```bash
+. skills/kugetsu/scripts/kugetsu-install.sh
+```
+
+### For Agents (Self-Install)
+Copy the script to your PATH:
+```bash
+cp skills/kugetsu/scripts/kugetsu ~/.local/bin/kugetsu
+chmod +x ~/.local/bin/kugetsu
+```
+
+Or source directly when needed:
+```bash
+. skills/kugetsu/scripts/kugetsu
+```
+
+## Session State
+
+| State | Meaning | Resumable? |
+|-------|---------|------------|
+| `used` | Session is active (process running) | Yes (with confirmation) |
+| `idle` | Session ended gracefully | No |
+| `left` | Session interrupted/crashed | Yes |
+| `invalid` | Session data missing/corrupt | No |
+
+## Session Directory
+
+Sessions are stored in `~/.kugetsu/sessions/<session_id>/`:
+- `state` - current state (used/idle/left/invalid)
+- `message` - last user message (for auto-fill)
+- `pid` - active process PID (when used)
+
+## Commands
+
+### kugetsu start `<session_id>` `<message>`
+Start a new session:
+```bash
+kugetsu start mytask "fix bug #1"
+```
+- Creates session directory
+- Sets state to `used`
+- Stores PID and message
+- Runs: `opencode run --session <session_id> <message>`
+
+### kugetsu list [--all]
+List sessions:
+```bash
+kugetsu list          # Shows only `left` (resumable)
+kugetsu list --all    # Shows all states
+```
+
+### kugetsu resume `<session_id>` [message]
+Resume an interrupted session:
+```bash
+kugetsu resume mytask                 # Auto-fills last message
+kugetsu resume mytask "continue"     # Uses provided message
+```
+- If state is `used`: prompts for confirmation (someone else might be using)
+- If state is `idle`: errors (not resumable)
+- If state is `left`: proceeds with message
+
+### kugetsu stop `<session_id>`
+Stop a session gracefully:
+```bash
+kugetsu stop mytask
+```
+- Sends SIGTERM to process
+- Sets state to `idle`
+
+### kugetsu destroy `<session_id>` [-y]
+Delete a session:
+```bash
+kugetsu destroy mytask          # Prompts for confirmation (default: N)
+kugetsu destroy mytask -y        # Skips confirmation
+```
+- Errors if session is `used` (use `stop` first)
+- Errors if session not found
+
+### kugetsu destroy --all [-y]
+Delete all sessions:
+```bash
+kugetsu destroy --all            # Prompts for confirmation (default: N)
+kugetsu destroy --all -y         # Skips confirmation
+```
+- Useful for fresh start
+
+### kugetsu help
+Show usage help.
+
+## State Transitions
+
+```
+start ──────────────► used ──────► idle (stop/SIGTERM)
+                         │
+                         └──────► left (kill/SIGINT/crash)
+                                        │
+                                        ▼
+                                    destroy (delete)
+```
+
+## Example Workflow
+
+```bash
+# Start a long-running task
+kugetsu start issue42 "implement feature X"
+
+# ... time passes, connection drops ...
+
+# Check what sessions are resumable
+kugetsu list
+
+# Resume with auto-filled message
+kugetsu resume issue42
+
+# Later, when done
+kugetsu stop issue42
+
+# When you want a fresh start
+kugetsu destroy --all
+```
+
+## Without kugetsu
+
+If kugetsu is not installed, use opencode directly:
+```bash
+opencode run --session mytask "task description"
+opencode run --continue --session mytask "continue"
+opencode session list
+```
+Tradeoff: No state tracking, no auto-fill, no filtered list, no confirmation prompts.

skills/kugetsu/scripts/kugetsu

@@ -0,0 +1,440 @@
+#!/bin/bash
+set -euo pipefail
+
+KUGETSU_DIR="${KUGETSU_DIR:-$HOME/.kugetsu}"
+SESSIONS_DIR="$KUGETSU_DIR/sessions"
+BIN_DIR="$KUGETSU_DIR/bin"
+
+usage() {
+    cat << 'EOF'
+kugetsu - OpenCode Session Manager
+
+Usage:
+    kugetsu start <session_id> <message>    Start a new session
+    kugetsu list [--all]                     List sessions (default: left only)
+    kugetsu resume <session_id> [message]   Resume a session
+    kugetsu stop <session_id>               Stop a session gracefully
+    kugetsu destroy <session_id> [-y]        Delete a session (prompts confirmation)
+    kugetsu destroy --all [-y]               Delete all sessions (prompts confirmation)
+    kugetsu help                             Show this help
+
+States:
+    used   - Session is active (process running)
+    idle   - Session ended gracefully (not resumable)
+    left   - Session interrupted/crashed (resumable)
+    invalid - Session data missing/corrupt
+
+Examples:
+    kugetsu start mytask "fix bug #1"
+    kugetsu list
+    kugetsu list --all
+    kugetsu resume mytask
+    kugetsu resume mytask "continue working"
+    kugetsu stop mytask
+    kugetsu destroy mytask
+    kugetsu destroy mytask -y
+    kugetsu destroy --all
+    kugetsu destroy --all -y
+EOF
+}
+
+ensure_dirs() {
+    mkdir -p "$SESSIONS_DIR" "$BIN_DIR"
+}
+
+validate_session_id() {
+    local session_id="$1"
+    if [ -z "$session_id" ]; then
+        echo "Error: session_id cannot be empty" >&2
+        exit 1
+    fi
+}
+
+get_session_dir() {
+    local session_id="$1"
+    echo "$SESSIONS_DIR/$session_id"
+}
+
+get_state() {
+    local session_dir="$1"
+    if [ -f "$session_dir/state" ]; then
+        cat "$session_dir/state"
+    else
+        echo "invalid"
+    fi
+}
+
+set_state() {
+    local session_dir="$1"
+    local state="$2"
+    echo "$state" > "$session_dir/state"
+}
+
+is_process_running() {
+    local pid="$1"
+    if kill -0 "$pid" 2>/dev/null; then
+        return 0
+    else
+        return 1
+    fi
+}
+
+check_and_update_state() {
+    local session_dir="$1"
+    local state=$(get_state "$session_dir")
+    
+    if [ "$state" = "used" ]; then
+        local pid_file="$session_dir/pid"
+        if [ -f "$pid_file" ]; then
+            local pid=$(cat "$pid_file")
+            if ! is_process_running "$pid"; then
+                set_state "$session_dir" "left"
+                return 1
+            fi
+        else
+            set_state "$session_dir" "left"
+            return 1
+        fi
+    fi
+    return 0
+}
+
+cmd_start() {
+    if [ $# -lt 2 ]; then
+        echo "Error: start requires <session_id> and <message>" >&2
+        exit 1
+    fi
+    
+    local session_id="$1"
+    local message="$2"
+    validate_session_id "$session_id"
+    local session_dir=$(get_session_dir "$session_id")
+    
+    ensure_dirs
+    
+    if [ -d "$session_dir" ]; then
+        local state=$(get_state "$session_dir")
+        check_and_update_state "$session_dir"
+        state=$(get_state "$session_dir")
+        
+        if [ "$state" = "used" ]; then
+            echo "Error: session '$session_id' is already in use (state=used)" >&2
+            echo "Use 'kugetsu list' to see all sessions, or 'kugetsu resume $session_id' to resume" >&2
+            exit 1
+        fi
+        
+        if [ "$state" = "left" ]; then
+            echo "Warning: session '$session_id' was left interrupted" >&2
+            echo "Resuming instead of starting new..." >&2
+            cmd_resume "$session_id" "$message"
+            return
+        fi
+    fi
+    
+    mkdir -p "$session_dir"
+    set_state "$session_dir" "used"
+    echo "$$" > "$session_dir/pid"
+    echo "$message" > "$session_dir/message"
+    
+    echo "Starting session '$session_id'..."
+    opencode run --session "$session_id" "$message"
+    local exit_code=$?
+    
+    if [ $exit_code -eq 0 ]; then
+        set_state "$session_dir" "idle"
+    else
+        set_state "$session_dir" "left"
+    fi
+    
+    rm -f "$session_dir/pid"
+}
+
+cmd_list() {
+    local show_all=false
+    if [ $# -ge 1 ] && [ "$1" = "--all" ]; then
+        show_all=true
+    fi
+    
+    ensure_dirs
+    
+    printf "%-20s %-10s %-s\n" "SESSION_ID" "STATE" "LAST_MESSAGE"
+    printf "%-20s %-10s %-s\n" "──────────" "─────" "───────────"
+    
+    for session_dir in "$SESSIONS_DIR"/*; do
+        if [ -d "$session_dir" ]; then
+            local session_id=$(basename "$session_dir")
+            check_and_update_state "$session_dir"
+            local state=$(get_state "$session_dir")
+            
+            if [ "$show_all" = false ] && [ "$state" != "left" ]; then
+                continue
+            fi
+            
+            local message=""
+            if [ -f "$session_dir/message" ]; then
+                message=$(cat "$session_dir/message")
+                if [ ${#message} -gt 40 ]; then
+                    message="${message:0:37}..."
+                fi
+            fi
+            
+            printf "%-20s %-10s %-s\n" "$session_id" "$state" "$message"
+        fi
+    done
+}
+
+cmd_resume() {
+    if [ $# -lt 1 ]; then
+        echo "Error: resume requires <session_id>" >&2
+        exit 1
+    fi
+    
+    local session_id="$1"
+    local message=""
+    validate_session_id "$session_id"
+    
+    if [ $# -ge 2 ]; then
+        message="$2"
+    fi
+    
+    local session_dir=$(get_session_dir "$session_id")
+    
+    if [ ! -d "$session_dir" ]; then
+        echo "Error: session '$session_id' not found" >&2
+        exit 1
+    fi
+    
+    check_and_update_state "$session_dir"
+    local state=$(get_state "$session_dir")
+    
+    if [ "$state" = "used" ]; then
+        echo "Warning: session '$session_id' is marked as used" >&2
+        local pid=""
+        if [ -f "$session_dir/pid" ]; then
+            pid=$(cat "$session_dir/pid")
+        fi
+        if [ -n "$pid" ] && is_process_running "$pid"; then
+            echo "Error: process $pid is still running for this session" >&2
+            exit 1
+        else
+            set_state "$session_dir" "left"
+            state="left"
+        fi
+    fi
+    
+    if [ "$state" = "idle" ]; then
+        echo "Error: session '$session_id' ended gracefully (state=idle)" >&2
+        echo "This session cannot be resumed. Start a new session instead." >&2
+        exit 1
+    fi
+    
+    if [ "$state" = "invalid" ]; then
+        echo "Error: session '$session_id' is invalid (state=invalid)" >&2
+        exit 1
+    fi
+    
+    if [ -z "$message" ]; then
+        if [ -f "$session_dir/message" ]; then
+            message=$(cat "$session_dir/message")
+            echo "Auto-filled message: $message"
+        else
+            echo "Error: no message stored for session '$session_id'" >&2
+            echo "Provide a message as second argument: kugetsu resume $session_id <message>" >&2
+            exit 1
+        fi
+    else
+        echo "Using provided message: $message"
+    fi
+    
+    set_state "$session_dir" "used"
+    echo "$$" > "$session_dir/pid"
+    echo "$message" > "$session_dir/message"
+    
+    echo "Resuming session '$session_id'..."
+    opencode run --continue --session "$session_id" "$message"
+    local exit_code=$?
+    
+    if [ $exit_code -eq 0 ]; then
+        set_state "$session_dir" "idle"
+    else
+        set_state "$session_dir" "left"
+    fi
+    
+    rm -f "$session_dir/pid"
+}
+
+cmd_stop() {
+    if [ $# -lt 1 ]; then
+        echo "Error: stop requires <session_id>" >&2
+        exit 1
+    fi
+    
+    local session_id="$1"
+    validate_session_id "$session_id"
+    local session_dir=$(get_session_dir "$session_id")
+    
+    if [ ! -d "$session_dir" ]; then
+        echo "Error: session '$session_id' not found" >&2
+        exit 1
+    fi
+    
+    local state=$(get_state "$session_dir")
+    
+    if [ "$state" != "used" ]; then
+        echo "Error: session '$session_id' is not in use (state=$state)" >&2
+        exit 1
+    fi
+    
+    local pid=""
+    if [ -f "$session_dir/pid" ]; then
+        pid=$(cat "$session_dir/pid")
+    fi
+    
+    if [ -n "$pid" ] && is_process_running "$pid"; then
+        echo "Sending SIGTERM to process $pid..."
+        kill -TERM "$pid" 2>/dev/null || true
+        
+        local count=0
+        while is_process_running "$pid" && [ $count -lt 10 ]; do
+            sleep 0.5
+            count=$((count + 1))
+        done
+        
+        if is_process_running "$pid"; then
+            echo "Process still running, sending SIGKILL..." >&2
+            kill -KILL "$pid" 2>/dev/null || true
+        fi
+    fi
+    
+    set_state "$session_dir" "idle"
+    rm -f "$session_dir/pid"
+    
+    echo "Session '$session_id' stopped"
+}
+
+cmd_destroy() {
+    local session_id=""
+    local destroy_all=false
+    local force=false
+    
+    while [ $# -gt 0 ]; do
+        case "$1" in
+            --all)
+                destroy_all=true
+                ;;
+            -y|--yes)
+                force=true
+                ;;
+            -*)
+                echo "Error: unknown option '$1'" >&2
+                exit 1
+                ;;
+            *)
+                if [ -n "$session_id" ]; then
+                    echo "Error: too many arguments" >&2
+                    exit 1
+                fi
+                session_id="$1"
+                ;;
+        esac
+        shift
+    done
+    
+    if [ "$destroy_all" = true ]; then
+        if [ -n "$session_id" ]; then
+            echo "Error: cannot specify session_id with --all" >&2
+            exit 1
+        fi
+        
+        if [ "$force" = true ]; then
+            rm -rf "$SESSIONS_DIR"/*
+            echo "All sessions deleted"
+            return
+        fi
+        
+        echo "Delete ALL sessions? [y/N] "
+        local reply
+        read reply
+        if [ "$reply" = "y" ] || [ "$reply" = "Y" ]; then
+            rm -rf "$SESSIONS_DIR"/*
+            echo "All sessions deleted"
+        else
+            echo "Aborted"
+        fi
+        return
+    fi
+    
+    if [ -z "$session_id" ]; then
+        echo "Error: destroy requires <session_id> or --all" >&2
+        exit 1
+    fi
+    
+    validate_session_id "$session_id"
+    local session_dir=$(get_session_dir "$session_id")
+    
+    if [ ! -d "$session_dir" ]; then
+        echo "Error: session '$session_id' not found" >&2
+        exit 1
+    fi
+    
+    local state=$(get_state "$session_dir")
+    if [ "$state" = "used" ]; then
+        echo "Error: session '$session_id' is in use (state=used)" >&2
+        echo "Use 'kugetsu stop $session_id' first" >&2
+        exit 1
+    fi
+    
+    if [ "$force" = true ]; then
+        rm -rf "$session_dir"
+        echo "Session '$session_id' deleted"
+        return
+    fi
+    
+    echo "Delete session '$session_id'? [y/N] "
+    local reply
+    read reply
+    if [ "$reply" = "y" ] || [ "$reply" = "Y" ]; then
+        rm -rf "$session_dir"
+        echo "Session '$session_id' deleted"
+    else
+        echo "Aborted"
+    fi
+}
+
+main() {
+    if [ $# -eq 0 ]; then
+        usage
+        exit 1
+    fi
+    
+    local command="$1"
+    shift
+    
+    case "$command" in
+        help|--help|-h)
+            usage
+            ;;
+        start)
+            cmd_start "$@"
+            ;;
+        list)
+            cmd_list "$@"
+            ;;
+        resume)
+            cmd_resume "$@"
+            ;;
+        stop)
+            cmd_stop "$@"
+            ;;
+        destroy)
+            cmd_destroy "$@"
+            ;;
+        *)
+            echo "Error: unknown command '$command'" >&2
+            usage
+            exit 1
+            ;;
+    esac
+}
+
+main "$@"

skills/kugetsu/scripts/kugetsu-install.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+set -euo pipefail
+
+KUGETSU_DIR="${KUGETSU_DIR:-$HOME/.kugetsu}"
+BIN_DIR="$KUGETSU_DIR/bin"
+
+echo "Installing kugetsu to $KUGETSU_DIR..."
+
+mkdir -p "$BIN_DIR"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+cp "$SCRIPT_DIR/kugetsu" "$BIN_DIR/kugetsu"
+chmod +x "$BIN_DIR/kugetsu"
+
+add_to_shell() {
+    local rc_file="$1"
+    local export_line="export PATH=\"\$HOME/.kugetsu/bin:\$PATH\""
+    
+    if [ -f "$rc_file" ]; then
+        if grep -q "$export_line" "$rc_file" 2>/dev/null; then
+            echo "$rc_file already has kugetsu in PATH"
+        else
+            echo "" >> "$rc_file"
+            echo "# kugetsu - opencode session manager" >> "$rc_file"
+            echo "$export_line" >> "$rc_file"
+            echo "Added to $rc_file"
+        fi
+    else
+        echo "" >> "$rc_file"
+        echo "# kugetsu - opencode session manager" >> "$rc_file"
+        echo "$export_line" >> "$rc_file"
+        echo "Created $rc_file with kugetsu PATH"
+    fi
+}
+
+add_to_shell "$HOME/.bashrc"
+add_to_shell "$HOME/.zshrc"
+
+echo ""
+echo "Installation complete!"
+echo ""
+echo "Run this to start using kugetsu immediately:"
+echo "    export PATH=\"\$HOME/.kugetsu/bin:\$PATH\""
+echo ""
+echo "Or start a new shell."
+echo ""
+echo "Usage:"
+echo "    kugetsu start <session_id> <message>   Start a new session"
+echo "    kugetsu list                          List sessions"
+echo "    kugetsu resume <session_id> [msg]     Resume a session"
+echo "    kugetsu stop <session_id>             Stop a session"
+echo "    kugetsu help                          Show help"

skills/kugetsu/tests/test-kugetsu.sh

@@ -0,0 +1,277 @@
+#!/bin/bash
+# kugetsu test suite
+# Run with: bash skills/kugetsu/tests/test-kugetsu.sh
+#
+# Memory management approach:
+# - Sequential test execution (no parallel)
+# - Cleanup between tests that spawn opencode
+# - No hard memory cap (ulimit -v breaks Bun/opencode)
+# - If OOM occurs, it is a known failure mode
+
+set -euo pipefail
+
+KUGETSU="./skills/kugetsu/scripts/kugetsu"
+TEST_SESSION_PREFIX="kugetsu-test-"
+PASS=0
+FAIL=0
+
+cleanup_sessions() {
+    for dir in ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}*; do
+        [ -d "$dir" ] && rm -rf "$dir" 2>/dev/null || true
+    done
+}
+
+cleanup_opencode() {
+    pkill -f "opencode.*${TEST_SESSION_PREFIX}" 2>/dev/null || true
+    pkill -f "kugetsu.*${TEST_SESSION_PREFIX}" 2>/dev/null || true
+    sleep 0.5
+}
+
+cleanup() {
+    cleanup_sessions
+    cleanup_opencode
+}
+
+pass() {
+    echo "✅ PASS: $1"
+    PASS=$((PASS + 1))
+}
+
+fail() {
+    echo "❌ FAIL: $1"
+    FAIL=$((FAIL + 1))
+}
+
+cleanup
+
+echo "=== kugetsu Test Suite ==="
+echo ""
+
+# Test 1: Help
+echo "--- Test: help ---"
+if $KUGETSU help 2>&1 | grep -q "kugetsu - OpenCode Session Manager"; then
+    pass "help displays usage"
+else
+    fail "help displays usage"
+fi
+echo ""
+
+# Test 2: List empty
+echo "--- Test: list (empty) ---"
+if $KUGETSU list 2>&1 | grep -q "SESSION_ID"; then
+    pass "list shows header even when empty"
+else
+    fail "list shows header even when empty"
+fi
+echo ""
+
+# Test 3: List --all empty
+echo "--- Test: list --all (empty) ---"
+if $KUGETSU list --all 2>&1 | grep -q "SESSION_ID"; then
+    pass "list --all shows header even when empty"
+else
+    fail "list --all shows header even when empty"
+fi
+echo ""
+
+# Test 4: Start session (quick exit)
+echo "--- Test: start session ---"
+if timeout 15 bash -c "$KUGETSU start ${TEST_SESSION_PREFIX}start-test 'echo hello'" 2>&1; then
+    if [ -d ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}start-test ]; then
+        pass "start creates session directory"
+    else
+        fail "start creates session directory"
+    fi
+else
+    fail "start runs successfully"
+fi
+echo ""
+
+# Test 5: List shows only left by default
+echo "--- Test: list default filters non-left ---"
+if ! $KUGETSU list 2>&1 | grep -q "${TEST_SESSION_PREFIX}start-test"; then
+    pass "list default hides idle sessions"
+else
+    fail "list default hides idle sessions"
+fi
+echo ""
+
+# Test 6: List --all shows all
+echo "--- Test: list --all shows all states ---"
+if $KUGETSU list --all 2>&1 | grep -q "${TEST_SESSION_PREFIX}start-test"; then
+    pass "list --all shows all sessions"
+else
+    fail "list --all shows all sessions"
+fi
+echo ""
+
+# Test 7: Resume with auto-fill
+echo "--- Test: resume auto-fill ---"
+mkdir -p ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}resume-test
+echo "left" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}resume-test/state
+echo "continue this task" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}resume-test/message
+
+OUTPUT=$(timeout 10 bash -c "$KUGETSU resume ${TEST_SESSION_PREFIX}resume-test" 2>&1 || true)
+if echo "$OUTPUT" | grep -q "Auto-filled message: continue this task"; then
+    pass "resume auto-fills stored message"
+else
+    fail "resume auto-fills stored message"
+fi
+cleanup
+echo ""
+
+# Test 8: Resume with provided message overrides
+echo "--- Test: resume with message overrides ---"
+mkdir -p ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}resume-override
+echo "left" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}resume-override/state
+echo "original message" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}resume-override/message
+
+OUTPUT=$(timeout 30 bash -c "$KUGETSU resume ${TEST_SESSION_PREFIX}resume-override 'new message'" 2>&1 || true)
+if echo "$OUTPUT" | grep -q "new message" && ! echo "$OUTPUT" | grep -q "Auto-filled message"; then
+    pass "resume uses provided message over auto-fill"
+else
+    fail "resume uses provided message over auto-fill: $OUTPUT"
+fi
+cleanup
+echo ""
+
+# Test 9: Resume idle session fails
+echo "--- Test: resume idle session fails ---"
+rm -rf ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}idle-test 2>/dev/null
+mkdir -p ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}idle-test
+echo "idle" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}idle-test/state
+
+OUTPUT=$(timeout 5 bash -c "$KUGETSU resume ${TEST_SESSION_PREFIX}idle-test" 2>&1 || true)
+if echo "$OUTPUT" | grep -q "cannot be resumed"; then
+    pass "resume idle session fails with message"
+else
+    echo "DEBUG: $OUTPUT"
+    fail "resume idle session fails with message"
+fi
+echo ""
+
+# Test 10: Resume non-existent session fails
+echo "--- Test: resume non-existent session fails ---"
+rm -rf ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}nonexistent 2>/dev/null
+OUTPUT=$(timeout 5 bash -c "$KUGETSU resume ${TEST_SESSION_PREFIX}nonexistent" 2>&1 || true)
+if echo "$OUTPUT" | grep -q "not found"; then
+    pass "resume non-existent session fails"
+else
+    echo "DEBUG: $OUTPUT"
+    fail "resume non-existent session fails"
+fi
+echo ""
+
+# Test 11: Stop non-used session fails
+echo "--- Test: stop non-used session fails ---"
+rm -rf ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}notused 2>/dev/null
+mkdir -p ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}notused
+echo "idle" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}notused/state
+
+OUTPUT=$(timeout 5 bash -c "$KUGETSU stop ${TEST_SESSION_PREFIX}notused" 2>&1 || true)
+if echo "$OUTPUT" | grep -q "not in use"; then
+    pass "stop non-used session fails"
+else
+    echo "DEBUG: $OUTPUT"
+    fail "stop non-used session fails"
+fi
+echo ""
+
+# Test 12: Start existing left session resumes instead
+echo "--- Test: start on left session resumes ---"
+mkdir -p ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}left-start
+echo "left" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}left-start/state
+echo "original task" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}left-start/message
+
+OUTPUT=$(timeout 10 bash -c "$KUGETSU start ${TEST_SESSION_PREFIX}left-start 'new task'" 2>&1 || true)
+if echo "$OUTPUT" | grep -q "Resuming instead"; then
+    pass "start on left session resumes"
+else
+    fail "start on left session resumes"
+fi
+cleanup
+echo ""
+
+# ============================================================================
+# FLAKY TESTS - Commented out due to timing/process behavior issues
+# ============================================================================
+
+# Test: Stop active session (FLAKY - timing dependent)
+# echo "--- Test: stop active session (FLAKY) ---"
+# (
+#     timeout 20 bash -c "$KUGETSU start ${TEST_SESSION_PREFIX}stop-test 'sleep 30'" 2>&1 &
+#     KUGETSU_PID=$!
+#     sleep 3
+#     
+#     # Check session is in use
+#     if ! $KUGETSU list --all 2>&1 | grep -q "${TEST_SESSION_PREFIX}stop-test.*used"; then
+#         echo "⚠️  SKIP (FLAKY): Could not verify session was used"
+#     elif timeout 5 bash -c "$KUGETSU stop ${TEST_SESSION_PREFIX}stop-test" 2>&1; then
+#         if [ "$(cat ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}stop-test/state 2>/dev/null)" = "idle" ]; then
+#             echo "✅ PASS (FLAKY): stop transitions to idle"
+#         else
+#             echo "❌ FAIL (FLAKY): stop does not transition to idle"
+#         fi
+#     else
+#         echo "❌ FAIL (FLAKY): stop command failed"
+#     fi
+#     
+#     wait $KUGETSU_PID 2>/dev/null || true
+# ) 2>&1 || true
+
+# Test: Interrupt session leaves state as left (FLAKY - opencode signal handling)
+# echo "--- Test: interrupt session leaves left (FLAKY) ---"
+# (
+#     bash -c "$KUGETSU start ${TEST_SESSION_PREFIX}interrupt-test 'sleep 30'" 2>&1 &
+#     KUGETSU_PID=$!
+#     sleep 3
+#     
+#     # Find and kill opencode process
+#     OPENCODE_PID=$(pgrep -f "opencode.*${TEST_SESSION_PREFIX}interrupt-test" | head -1 || true)
+#     if [ -n "$OPENCODE_PID" ]; then
+#         kill -9 $OPENCODE_PID 2>/dev/null || true
+#     fi
+#     
+#     wait $KUGETSU_PID 2>/dev/null || true
+#     sleep 1
+#     
+#     STATE=$(cat ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}interrupt-test/state 2>/dev/null || echo "unknown")
+#     if [ "$STATE" = "left" ]; then
+#         echo "✅ PASS (FLAKY): interrupt leaves state as left"
+#     else
+#         echo "❌ FAIL (FLAKY): interrupt left state=$STATE (expected left)"
+#     fi
+# ) 2>&1 || true
+
+# Test: Concurrent resume attempts (FLAKY - race condition)
+# echo "--- Test: concurrent resume (FLAKY) ---"
+# mkdir -p ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}concurrent
+# echo "left" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}concurrent/state
+# echo "test task" > ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}concurrent/message
+# 
+# (
+#     timeout 10 bash -c "$KUGETSU resume ${TEST_SESSION_PREFIX}concurrent" 2>&1 &
+#     timeout 10 bash -c "$KUGETSU resume ${TEST_SESSION_PREFIX}concurrent" 2>&1
+# ) 2>&1 || true
+# 
+# echo "⚠️  NOTE (FLAKY): This test is informational only - no assertion"
+# rm -rf ~/.kugetsu/sessions/${TEST_SESSION_PREFIX}concurrent
+
+# ============================================================================
+# Cleanup
+# ============================================================================
+cleanup
+
+echo ""
+echo "=== Test Summary ==="
+echo "Passed: $PASS"
+echo "Failed: $FAIL"
+echo ""
+
+if [ $FAIL -eq 0 ]; then
+    echo "All tests passed!"
+    exit 0
+else
+    echo "Some tests failed."
+    exit 1
+fi