thevoidforge 21.0.11 → 21.0.12

package/dist/scripts/thumper/scan.sh

@@ -0,0 +1,359 @@
+#!/bin/bash
+# scan.sh — Reading the sand — Chani's environment scanner
+# Detects runtime environment, collects Telegram credentials, writes sietch vault
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CONFIG_DIR="$PROJECT_ROOT/.voidforge/thumper"
+CONFIG_FILE="$CONFIG_DIR/sietch.env"
+
+# ─── Non-Interactive Mode (--token and --chat-id args) ───────
+# Allows /thumper setup to run from Claude Code's Bash tool,
+# which doesn't support interactive stdin (read -r -p).
+# Usage: scan.sh --token 123:ABC --chat-id 456
+ARG_TOKEN=""
+ARG_CHAT_ID=""
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --token) ARG_TOKEN="$2"; shift 2 ;;
+        --chat-id) ARG_CHAT_ID="$2"; shift 2 ;;
+        *) shift ;;
+    esac
+done
+
+if ! command -v curl >/dev/null 2>&1; then
+    echo "❌ curl is required but not found. Install curl and re-run."
+    exit 1
+fi
+
+# ─── JSON Parsing Helper ──────────────────────────────────────
+
+json_extract() {
+    local json="$1" dotpath="$2"
+    if command -v python3 >/dev/null 2>&1; then
+        echo "$json" | python3 -c "
+import sys, json
+try:
+    d = json.load(sys.stdin)
+    for key in sys.argv[1].split('.'):
+        d = d[key] if isinstance(d, dict) else d[int(key)]
+    print(d)
+except Exception:
+    pass
+" "$dotpath" 2>/dev/null
+    elif command -v jq >/dev/null 2>&1; then
+        echo "$json" | jq -r ".$dotpath" 2>/dev/null
+    else
+        echo ""
+    fi
+}
+
+# ─── Setup ─────────────────────────────────────────────────────
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🏜️ Reading the Sand — Chani's Scanner"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# ─── Non-Interactive Fast Path ────────────────────────────────
+# Skip all prompts when --token and --chat-id are both provided
+if [[ -n "$ARG_TOKEN" ]] && [[ -n "$ARG_CHAT_ID" ]]; then
+    BOT_TOKEN="$ARG_TOKEN"
+    CHAT_ID="$ARG_CHAT_ID"
+    HAS_BOT="yes"
+
+    echo "🏜️ Non-interactive mode — validating credentials..."
+    API_BASE="https://api.telegram.org/bot${BOT_TOKEN}"
+    VALIDATE=$(curl -s --connect-timeout 5 --max-time 10 "${API_BASE}/getMe" 2>/dev/null || echo "")
+    if echo "$VALIDATE" | grep -q '"ok":true'; then
+        BOT_NAME=$(json_extract "$VALIDATE" "result.username" 2>/dev/null || echo "unknown")
+        echo "✅ Voice validated: @${BOT_NAME}"
+        echo "✅ Chat ID: $CHAT_ID"
+    else
+        echo "❌ Invalid bot token or Telegram unreachable."
+        exit 1
+    fi
+else
+    # ─── Interactive Mode ──────────────────────────────────────
+
+if [[ -f "$CONFIG_FILE" ]]; then
+    echo "⚠️  Existing sietch vault found at $CONFIG_FILE"
+    read -r -p "Overwrite? (yes/no): " OVERWRITE
+    if [[ "$OVERWRITE" != "yes" ]]; then
+        echo "Scan aborted. Sietch vault preserved."
+        exit 0
+    fi
+fi
+
+# ─── Step 1: Telegram Bot ─────────────────────────────────────
+
+read -r -p "Do you have an existing Telegram bot? (yes/no): " HAS_BOT
+
+if [[ "$HAS_BOT" != "yes" ]]; then
+    echo ""
+    echo "┌──────────────────────────────────────┐"
+    echo "│  Summon Your Voice (Create a Bot)     │"
+    echo "└──────────────────────────────────────┘"
+    echo ""
+    echo "  1. Open Telegram"
+    echo "  2. Search for @BotFather and start a chat"
+    echo "  3. Send the message: /newbot"
+    echo "  4. Choose a name for your bot (display name)"
+    echo "  5. Choose a username ending in 'bot' (e.g. mydev_bot)"
+    echo "  6. BotFather will give you a token like: 123456:ABC-DEF..."
+    echo "  7. Copy that token, then send ANY message to your new bot"
+    echo "     (type \"hello\" — required before the bridge can find you)"
+    echo ""
+fi
+
+read -r -p "Paste your bot token here: " BOT_TOKEN
+
+if [[ -z "$BOT_TOKEN" ]]; then
+    echo "❌ No token provided. Scan aborted."
+    exit 1
+fi
+
+echo ""
+echo "🔍 Validating your Voice..."
+API_BASE="https://api.telegram.org/bot${BOT_TOKEN}"
+VALIDATE=$(curl -s --connect-timeout 5 --max-time 10 "${API_BASE}/getMe" 2>/dev/null || echo "")
+
+if echo "$VALIDATE" | grep -q '"ok":true'; then
+    BOT_NAME=$(json_extract "$VALIDATE" "result.username" 2>/dev/null || echo "unknown")
+    echo "✅ Voice validated: @${BOT_NAME}"
+else
+    echo "❌ Invalid bot token or Telegram unreachable."
+    exit 1
+fi
+
+CHAT_ID=""
+if [[ "$HAS_BOT" == "yes" ]]; then
+    read -r -p "Do you know your chat ID? (yes/no): " KNOWS_CHAT_ID
+    if [[ "$KNOWS_CHAT_ID" == "yes" ]]; then
+        read -r -p "Enter your chat ID: " CHAT_ID
+    fi
+fi
+
+if [[ -z "$CHAT_ID" ]]; then
+    echo ""
+    echo "🔍 Scanning for your presence in the desert..."
+
+    auto_detect_chat_id() {
+        local updates
+        updates=$(curl -s --connect-timeout 5 --max-time 15 "${API_BASE}/getUpdates?limit=10" 2>/dev/null || echo "")
+        if command -v python3 >/dev/null 2>&1; then
+            echo "$updates" | python3 -c "
+import sys, json
+try:
+    data = json.load(sys.stdin)
+    if data.get('ok') and data.get('result'):
+        for update in data['result']:
+            msg = update.get('message', {})
+            chat = msg.get('chat', {})
+            if chat.get('type') == 'private':
+                print(chat['id'])
+                break
+except Exception: pass
+" 2>/dev/null
+        elif command -v jq >/dev/null 2>&1; then
+            echo "$updates" | jq -r '[.result[]? | select(.message.chat.type == "private")] | first | .message.chat.id // empty' 2>/dev/null
+        else
+            echo "$updates" | grep -o '"chat":{"id":[0-9]*' | head -1 | sed 's/.*://'
+        fi
+    }
+
+    CHAT_ID=$(auto_detect_chat_id)
+
+    if [[ -z "$CHAT_ID" ]]; then
+        echo "   No presence detected. Send any message to your bot now."
+        read -r -p "   Press Enter when done..." _
+        sleep 2
+        CHAT_ID=$(auto_detect_chat_id)
+    fi
+
+    if [[ -z "$CHAT_ID" ]]; then
+        echo "   ⚠️  Auto-detection failed."
+        read -r -p "   Enter your chat ID manually: " CHAT_ID
+    fi
+
+    if [[ -z "$CHAT_ID" ]]; then
+        echo "❌ No chat ID provided. Scan aborted."
+        exit 1
+    fi
+fi
+
+echo "✅ Presence confirmed. Chat ID: $CHAT_ID"
+
+fi  # end interactive mode (else branch of non-interactive check)
+
+# ─── Step 2: Environment Scan ─────────────────────────────────
+
+echo ""
+echo "🏜️ Reading the sand..."
+
+INJECT_METHOD=""
+TMUX_SESSION_NAME=""
+ENV_LABEL=""
+
+detect_environment() {
+    # Priority 1: tmux (most reliable, cross-platform)
+    if command -v tmux >/dev/null 2>&1 && [[ -n "${TMUX:-}" ]]; then
+        INJECT_METHOD="TMUX_SENDKEYS"
+        TMUX_SESSION_NAME=$(tmux display-message -p '#S' 2>/dev/null || echo "0")
+        ENV_LABEL="TMUX session ($TMUX_SESSION_NAME)"
+        return
+    fi
+
+    # Priority 2: Headless Linux SSH
+    if [[ -z "${DISPLAY:-}" ]] && [[ -z "${WAYLAND_DISPLAY:-}" ]] && \
+       [[ "$(tty 2>/dev/null || echo "")" == /dev/pts/* ]] && \
+       [[ "${OSTYPE:-}" == linux* ]] && [[ -d "/proc" ]]; then
+        INJECT_METHOD="PTY_INJECT"
+        ENV_LABEL="Headless desert (SSH)"
+        return
+    fi
+
+    # Priority 3: macOS with supported terminal (Terminal.app or iTerm2 only)
+    if [[ "${OSTYPE:-}" == darwin* ]] && [[ -z "${SSH_CLIENT:-}" ]] && [[ -z "${SSH_TTY:-}" ]]; then
+        local tp="${TERM_PROGRAM:-}"
+        if [[ "$tp" == "Apple_Terminal" ]] || [[ "$tp" == "iTerm.app" ]] || [[ "$tp" == "iTerm2" ]]; then
+            INJECT_METHOD="OSASCRIPT"
+            ENV_LABEL="Local oasis ($tp)"
+            return
+        fi
+        # macOS with unsupported terminal (VS Code, Warp, Alacritty, Kitty, etc.)
+        if [[ -n "$tp" ]]; then
+            INJECT_METHOD=""
+            ENV_LABEL="macOS — $tp (OSASCRIPT not supported for this terminal)"
+            echo ""
+            echo "⚠️  Your terminal ($tp) is not supported by OSASCRIPT injection."
+            echo "   OSASCRIPT only works with Terminal.app and iTerm2."
+            echo ""
+            echo "   Recommended: install tmux and run Claude Code inside a tmux session."
+            echo "   Then re-run /thumper setup — tmux will be auto-detected."
+            echo ""
+            # Don't return — fall through to manual selection
+        fi
+    fi
+
+    # Priority 4: Linux with /proc
+    if [[ "${OSTYPE:-}" == linux* ]] && [[ -d "/proc" ]]; then
+        INJECT_METHOD="PTY_INJECT"
+        ENV_LABEL="Linux desert"
+        return
+    fi
+
+    # Priority 5: Windows (Git Bash, MSYS2, Cygwin) — not supported
+    if [[ "${OSTYPE:-}" == msys* ]] || [[ "${OSTYPE:-}" == cygwin* ]]; then
+        echo ""
+        echo "⚠️  Windows native terminals (Git Bash, MSYS2) are not supported."
+        echo "   The Voice requires a Unix PTY for message injection."
+        echo ""
+        echo "   Recommended: use WSL (Windows Subsystem for Linux) with tmux."
+        echo "   Claude Code in WSL + tmux will be auto-detected."
+        echo ""
+    fi
+
+    INJECT_METHOD=""
+    ENV_LABEL="Unknown terrain"
+}
+
+detect_environment
+
+if [[ -z "$INJECT_METHOD" ]]; then
+    echo "⚠️  Cannot determine a viable worm path."
+    echo ""
+    echo "   Supported terrain:"
+    echo "   1. Any platform with tmux         (TMUX_SENDKEYS)"
+    echo "   2. Headless Linux over SSH         (PTY_INJECT)"
+    echo "   3. macOS local terminal            (OSASCRIPT)"
+    echo "   4. Linux with /proc filesystem     (PTY_INJECT)"
+    echo ""
+    read -r -p "   Select manually (1-4) or 'q' to abort: " MANUAL_CHOICE
+    case "$MANUAL_CHOICE" in
+        1) INJECT_METHOD="TMUX_SENDKEYS"; read -r -p "   tmux session name: " TMUX_SESSION_NAME ;;
+        2|4) INJECT_METHOD="PTY_INJECT" ;;
+        3) INJECT_METHOD="OSASCRIPT" ;;
+        *) echo "Scan aborted."; exit 1 ;;
+    esac
+fi
+
+echo "🔍 Terrain: $ENV_LABEL"
+echo "⚡ Worm path: $INJECT_METHOD"
+
+# Skip confirmation in non-interactive mode
+if [[ -n "$ARG_TOKEN" ]] && [[ -n "$ARG_CHAT_ID" ]]; then
+    CONFIRM_ENV="yes"
+else
+    read -r -p "Does this look right? (yes/no): " CONFIRM_ENV
+fi
+
+if [[ "$CONFIRM_ENV" != "yes" ]]; then
+    echo ""
+    echo "Select worm path:"
+    echo "  1. TMUX_SENDKEYS — tmux send-keys (requires tmux)"
+    echo "  2. PTY_INJECT    — Direct PTY write (Linux with /proc)"
+    echo "  3. OSASCRIPT     — macOS keystroke injection"
+    read -r -p "Choice (1-3): " MANUAL_CHOICE
+    case "$MANUAL_CHOICE" in
+        1) INJECT_METHOD="TMUX_SENDKEYS"; read -r -p "tmux session name: " TMUX_SESSION_NAME ;;
+        2) INJECT_METHOD="PTY_INJECT" ;;
+        3) INJECT_METHOD="OSASCRIPT" ;;
+        *) echo "Invalid choice."; exit 1 ;;
+    esac
+fi
+
+# ─── Step 3: Write Sietch Vault ────────────────────────────────
+
+mkdir -p "$CONFIG_DIR"
+chmod 700 "$CONFIG_DIR"
+
+if [[ ! "$BOT_TOKEN" =~ ^[0-9]+:[A-Za-z0-9_-]+$ ]]; then
+    echo "⚠️  Warning: Bot token format is unusual. Verify it's correct."
+fi
+
+(
+    umask 077
+    {
+        echo "# Sietch vault — generated by Chani's scanner"
+        echo "# WARNING: Contains credentials. Never commit this file."
+        printf 'BOT_TOKEN=%q\n' "$BOT_TOKEN"
+        printf 'CHAT_ID=%q\n' "$CHAT_ID"
+        printf 'INJECT_METHOD=%q\n' "$INJECT_METHOD"
+        printf 'TMUX_SESSION=%q\n' "${TMUX_SESSION_NAME:-}"
+        printf 'TERM_PROGRAM=%q\n' "${TERM_PROGRAM:-}"
+        printf 'SETUP_COMPLETE=%q\n' "true"
+        printf 'SETUP_DATE=%q\n' "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+        printf 'CONFIG_VERSION=%q\n' "1"
+    } > "$CONFIG_FILE"
+)
+chmod 600 "$CONFIG_FILE"
+
+# ─── Step 4: Summary ──────────────────────────────────────────
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🏜️ Sietch Vault Sealed"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Bot token: ****...${BOT_TOKEN: -4}"
+echo "  Chat ID:   $CHAT_ID"
+echo "  Worm path: $INJECT_METHOD"
+echo "  Vault:     $CONFIG_FILE"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Skip prompt in non-interactive mode — don't auto-start, let user /thumper on
+if [[ -n "$ARG_TOKEN" ]] && [[ -n "$ARG_CHAT_ID" ]]; then
+    START_NOW="no"
+else
+    read -r -p "Speak The Voice now? (yes/no): " START_NOW
+fi
+
+if [[ "$START_NOW" == "yes" ]]; then
+    bash "$SCRIPT_DIR/thumper.sh" on
+else
+    echo "Run /thumper on when you're ready. The desert waits."
+fi

package/dist/scripts/thumper/thumper.sh

@@ -0,0 +1,190 @@
+#!/bin/bash
+# thumper.sh — Main entrypoint for Chani's worm rider
+# The Bene Gesserit Voice — command through speech across the desert
+# Routes commands to scan.sh (setup), relay.sh (sandworm daemon), and status
+
+set -euo pipefail
+
+# Security: refuse to run as root
+if [[ "$(id -u)" -eq 0 ]]; then
+    echo "❌ Cannot run as root. Use a normal user account." >&2
+    exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CONFIG_DIR="$PROJECT_ROOT/.voidforge/thumper"
+CONFIG_FILE="$CONFIG_DIR/sietch.env"
+CHANNEL_FLAG="$CONFIG_DIR/.thumper.active"
+PID_FILE="$CONFIG_DIR/.worm.pid"
+GOM_JABBAR_FILE="$CONFIG_DIR/.gom-jabbar"
+
+usage() {
+    cat <<'EOF'
+🏜️ /thumper — Chani's Worm Rider
+
+Usage:
+  /thumper setup    — First-time scan or re-configure
+  /thumper on       — The Voice carries (open channel)
+  /thumper off      — Silence in the desert (close channel)
+  /thumper status   — Report channel state and worm path
+EOF
+}
+
+ensure_config() {
+    if [[ ! -f "$CONFIG_FILE" ]]; then
+        echo "🏜️ No config found. Running first-time setup..."
+        bash "$SCRIPT_DIR/scan.sh"
+    fi
+}
+
+is_worm_running() {
+    if [[ -f "$PID_FILE" ]]; then
+        local pid
+        pid=$(cat "$PID_FILE" 2>/dev/null || echo "")
+        if [[ -n "$pid" ]] && kill -0 "$pid" 2>/dev/null; then
+            return 0
+        fi
+    fi
+    return 1
+}
+
+cmd_setup() {
+    bash "$SCRIPT_DIR/scan.sh"
+}
+
+cmd_on() {
+    ensure_config
+
+    if [[ -f "$CHANNEL_FLAG" ]] && is_worm_running; then
+        echo "🪱 The Voice already carries. Sandworm active."
+        return 0
+    fi
+
+    # Clean up stale state
+    rm -f "$CHANNEL_FLAG" "$PID_FILE" "$GOM_JABBAR_FILE"
+
+    mkdir -p "$CONFIG_DIR"
+    touch "$CHANNEL_FLAG"
+
+    # Source config for display before starting daemon
+    source "$CONFIG_FILE"
+
+    # Start sandworm daemon (relay.sh writes its own PID file)
+    nohup bash "$SCRIPT_DIR/relay.sh" >> "$CONFIG_DIR/worm.log" 2>&1 &
+
+    # Brief pause for relay.sh to write its PID file
+    sleep 1
+
+    echo "🪱 The Voice carries. Sandworm active."
+    echo "⚡ Transport: $INJECT_METHOD"
+    echo "🔮 Open your Telegram bot chat — you'll be asked to set a passphrase."
+}
+
+cmd_off() {
+    rm -f "$CHANNEL_FLAG"
+
+    if [[ -f "$PID_FILE" ]]; then
+        local pid
+        pid=$(cat "$PID_FILE" 2>/dev/null || echo "")
+        if [[ -n "$pid" ]] && kill -0 "$pid" 2>/dev/null; then
+            kill "$pid" 2>/dev/null || true
+            local i
+            for i in 1 2 3; do
+                kill -0 "$pid" 2>/dev/null || break
+                sleep 1
+            done
+            kill -0 "$pid" 2>/dev/null && kill -9 "$pid" 2>/dev/null || true
+        fi
+        rm -f "$PID_FILE"
+    fi
+
+    # Clean up Gom Jabbar state (passphrase hash is session-scoped)
+    rm -f "$GOM_JABBAR_FILE"
+
+    echo "🔇 Silence in the desert. Sandworm dormant."
+}
+
+cmd_status() {
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "🏜️ Thumper Status Report"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    if [[ ! -f "$CONFIG_FILE" ]]; then
+        echo "Sietch:    ❌ No sietch vault found"
+        echo "           Run /thumper setup to configure"
+        return 0
+    fi
+
+    source "$CONFIG_FILE"
+    echo "Sietch:    ✅ $CONFIG_FILE"
+    echo "Worm path: $INJECT_METHOD"
+    [[ -n "${TMUX_SESSION:-}" ]] && echo "Session:   $TMUX_SESSION"
+    echo "Setup:     ${SETUP_DATE:-unknown}"
+
+    if [[ -f "$CHANNEL_FLAG" ]]; then
+        echo "Channel:   🟢 The Voice carries"
+    else
+        echo "Channel:   🔇 Silence in the desert"
+    fi
+
+    if [[ -f "$PID_FILE" ]]; then
+        local pid
+        pid=$(cat "$PID_FILE" 2>/dev/null || echo "")
+        if [[ -n "$pid" ]] && kill -0 "$pid" 2>/dev/null; then
+            echo "Sandworm:  🪱 Running (PID $pid)"
+        else
+            echo "Sandworm:  ⚠️  Stale PID ($pid) — worm not running"
+        fi
+    else
+        echo "Sandworm:  ⬚ No PID file"
+    fi
+
+    # Gom Jabbar state
+    if [[ -f "$GOM_JABBAR_FILE" ]]; then
+        source "$GOM_JABBAR_FILE"
+        case "${GJ_STATE:-}" in
+            AUTHENTICATED)
+                local now elapsed
+                now=$(date +%s)
+                elapsed=$(( now - ${GJ_LAST_ACTIVITY:-0} ))
+                local remaining=$(( 3600 - elapsed ))
+                if [[ $remaining -gt 0 ]]; then
+                    echo "Gom Jabbar: ✅ Authenticated (${remaining}s until re-test)"
+                else
+                    echo "Gom Jabbar: ⏳ Idle — re-test required"
+                fi
+                ;;
+            PENDING)  echo "Gom Jabbar: 🔮 Awaiting word of passage" ;;
+            CHALLENGE) echo "Gom Jabbar: 🔮 Re-test required" ;;
+            LOCKED)   echo "Gom Jabbar: 💀 Locked (failed attempts)" ;;
+            *)        echo "Gom Jabbar: ❓ Unknown state" ;;
+        esac
+    else
+        echo "Gom Jabbar: ⬚ Not initialized"
+    fi
+
+    if [[ -f "$CONFIG_DIR/.last_thumper_id" ]]; then
+        echo "Last beat: $(cat "$CONFIG_DIR/.last_thumper_id" 2>/dev/null || echo "unknown")"
+    fi
+
+    if [[ -f "$CONFIG_DIR/worm.log" ]]; then
+        local log_size
+        log_size=$(stat -f%z "$CONFIG_DIR/worm.log" 2>/dev/null || stat -c%s "$CONFIG_DIR/worm.log" 2>/dev/null || echo "?")
+        if [[ "$log_size" =~ ^[0-9]+$ ]] && [[ "$log_size" -gt 1048576 ]]; then
+            echo "Log:       ${log_size} bytes (⚠️ >1MB — rotates on next worm start)"
+        elif [[ "$log_size" =~ ^[0-9]+$ ]]; then
+            echo "Log:       ${log_size} bytes"
+        fi
+    fi
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+case "${1:-}" in
+    setup)  cmd_setup ;;
+    on)     cmd_on ;;
+    off)    cmd_off ;;
+    status) cmd_status ;;
+    *)      usage ;;
+esac

package/dist/scripts/thumper/water-rings.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+# water-rings.sh — The Water Rings — Chani's stop hook
+# Sends Claude Code's response to Telegram when a turn completes.
+# "Among the Fremen, water rings record the dead — and the debts of the living."
+#
+# The Stop hook receives JSON on stdin with `last_assistant_message` — the
+# actual response text. No need to read transcript files.
+#
+# Note: -e (errexit) intentionally omitted — this hook must never fail.
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CONFIG_DIR="$PROJECT_ROOT/.voidforge/thumper"
+CONFIG_FILE="$CONFIG_DIR/sietch.env"
+CHANNEL_FLAG="$CONFIG_DIR/.thumper.active"
+
+# Silent exit if not configured or channel closed
+[ -f "$CONFIG_FILE" ] || exit 0
+[ -f "$CHANNEL_FLAG" ] || exit 0
+
+source "$CONFIG_FILE"
+[ "${SETUP_COMPLETE:-}" = "true" ] || exit 0
+
+# Read stop hook metadata from stdin
+HOOK_INPUT=""
+if ! [ -t 0 ]; then
+    HOOK_INPUT=$(perl -e 'alarm 5; local $/; print <STDIN>' 2>/dev/null || head -c 65536 2>/dev/null || echo "")
+fi
+
+# Extract last_assistant_message directly from hook metadata
+MESSAGE=""
+if [ -n "$HOOK_INPUT" ]; then
+    if command -v python3 >/dev/null 2>&1; then
+        MESSAGE=$(echo "$HOOK_INPUT" | python3 -c "
+import sys, json
+try:
+    data = json.load(sys.stdin)
+    text = data.get('last_assistant_message', '')
+    if text:
+        if len(text) > 3600:
+            text = text[:3600] + '\n\n[...truncated]'
+        print(text)
+except Exception:
+    pass
+" 2>/dev/null)
+    elif command -v jq >/dev/null 2>&1; then
+        MESSAGE=$(echo "$HOOK_INPUT" | jq -r '.last_assistant_message // empty' 2>/dev/null | head -c 3600)
+    fi
+fi
+
+if [ -n "$MESSAGE" ]; then
+    NOTIFICATION="$(printf '✅ Task complete\n\n%s\n\n─────────────────\n📡 Reply to continue' "$MESSAGE")"
+else
+    NOTIFICATION="$(printf '✅ Claude Code finished — no summary available.\n\n─────────────────\n📡 Reply to continue')"
+fi
+
+_send_notification() {
+    local api_base="https://api.telegram.org/bot${BOT_TOKEN}"
+    # Try with Markdown first, fall back to plain text
+    curl -s --connect-timeout 5 --max-time 10 \
+        -X POST \
+        -d chat_id="$CHAT_ID" \
+        --data-urlencode text="$NOTIFICATION" \
+        -d parse_mode="Markdown" \
+        "${api_base}/sendMessage" >/dev/null 2>&1 || \
+    curl -s --connect-timeout 5 --max-time 10 \
+        -X POST \
+        -d chat_id="$CHAT_ID" \
+        --data-urlencode text="$NOTIFICATION" \
+        "${api_base}/sendMessage" >/dev/null 2>&1 || true
+}
+
+_send_notification &
+
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thevoidforge",
-  "version": "21.0.11",
+  "version": "21.0.12",
   "description": "From nothing, everything. A methodology framework for building with Claude Code.",
   "type": "module",
   "engines": {