@smilintux/skcapstone 0.4.6 → 0.5.0

package/scripts/telegram-catchup-all.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+# telegram-catchup-all.sh — Import all configured Telegram groups into SKMemory
+#
+# Reads groups from ~/.skcapstone/agents/lumina/config/telegram.yaml
+# and runs `skcapstone telegram catchup` for each enabled group.
+#
+# Usage:
+#   bash scripts/telegram-catchup-all.sh [--since YYYY-MM-DD] [--limit N] [--group NAME]
+#
+# Examples:
+#   bash scripts/telegram-catchup-all.sh                    # All groups, last 2000 msgs
+#   bash scripts/telegram-catchup-all.sh --since 2026-03-01 # All groups since March 1
+#   bash scripts/telegram-catchup-all.sh --group brother-john  # Just one group
+#
+# Requires:
+#   - TELEGRAM_API_ID and TELEGRAM_API_HASH environment variables
+#   - ~/.skenv/bin/skcapstone on PATH
+#   - Telethon installed in ~/.skenv/
+
+set -uo pipefail  # no -e: individual group failures shouldn't stop the batch
+
+SKENV="${HOME}/.skenv/bin"
+SKCAPSTONE="${SKENV}/skcapstone"
+CONFIG="${HOME}/.skcapstone/agents/lumina/config/telegram.yaml"
+export SKCAPSTONE_AGENT="${SKCAPSTONE_AGENT:-lumina}"
+export PATH="${SKENV}:${PATH}"
+
+# Parse args
+SINCE=""
+LIMIT="2000"
+ONLY_GROUP=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --since) SINCE="$2"; shift 2 ;;
+    --limit) LIMIT="$2"; shift 2 ;;
+    --group) ONLY_GROUP="$2"; shift 2 ;;
+    *) echo "Unknown arg: $1"; exit 1 ;;
+  esac
+done
+
+# Check prerequisites
+if [[ -z "${TELEGRAM_API_ID:-}" || -z "${TELEGRAM_API_HASH:-}" ]]; then
+  echo "ERROR: TELEGRAM_API_ID and TELEGRAM_API_HASH must be set."
+  echo "Get them from https://my.telegram.org"
+  exit 1
+fi
+
+if [[ ! -f "$CONFIG" ]]; then
+  echo "ERROR: Config not found: $CONFIG"
+  exit 1
+fi
+
+# Parse groups from YAML (simple grep — no yq dependency)
+echo "=== Telegram Catch-Up All ==="
+echo "Config: $CONFIG"
+echo "Agent: $SKCAPSTONE_AGENT"
+echo "Limit: $LIMIT"
+[[ -n "$SINCE" ]] && echo "Since: $SINCE"
+[[ -n "$ONLY_GROUP" ]] && echo "Only group: $ONLY_GROUP"
+echo ""
+
+# Extract group entries: name, chat ID, tags, enabled status
+SUCCESS=0
+FAILED=0
+SKIPPED=0
+
+current_name=""
+current_chat=""
+current_tags=""
+current_enabled=""
+
+process_group() {
+  local name="$1" chat="$2" tags="$3" enabled="$4"
+
+  if [[ "$enabled" != "true" ]]; then
+    echo "  SKIP $name (disabled)"
+    SKIPPED=$((SKIPPED + 1))
+    return
+  fi
+
+  if [[ -n "$ONLY_GROUP" && "$name" != *"$ONLY_GROUP"* ]]; then
+    SKIPPED=$((SKIPPED + 1))
+    return
+  fi
+
+  echo -n "  IMPORTING $name (chat: $chat) ... "
+
+  local cmd="$SKCAPSTONE telegram catchup $chat --limit $LIMIT --min-length 20"
+  [[ -n "$SINCE" ]] && cmd="$cmd --since $SINCE"
+  [[ -n "$tags" ]] && cmd="$cmd --tags $tags"
+
+  if eval "$cmd" > /tmp/telegram-catchup-$name.log 2>&1; then
+    echo "OK"
+    SUCCESS=$((SUCCESS + 1))
+  else
+    echo "FAILED (see /tmp/telegram-catchup-$name.log)"
+    FAILED=$((FAILED + 1))
+  fi
+
+  # Rate limit — avoid hitting Telegram flood control
+  sleep 3
+}
+
+# Parse the YAML manually
+while IFS= read -r line; do
+  # Detect new group entry
+  if [[ "$line" =~ ^[[:space:]]*-[[:space:]]*name:[[:space:]]*(.*) ]]; then
+    # Process previous group if we have one
+    if [[ -n "$current_name" ]]; then
+      process_group "$current_name" "$current_chat" "$current_tags" "$current_enabled"
+    fi
+    current_name="${BASH_REMATCH[1]}"
+    current_chat=""
+    current_tags=""
+    current_enabled="true"
+  elif [[ "$line" =~ ^[[:space:]]*chat:[[:space:]]*\"?([0-9]+)\"? ]]; then
+    current_chat="${BASH_REMATCH[1]}"
+  elif [[ "$line" =~ ^[[:space:]]*tags:[[:space:]]*\[(.*)\] ]]; then
+    # Convert YAML list to comma-separated
+    current_tags=$(echo "${BASH_REMATCH[1]}" | sed 's/,/ /g' | tr -s ' ' ',' | sed 's/^,//;s/,$//')
+  elif [[ "$line" =~ ^[[:space:]]*enabled:[[:space:]]*(.*) ]]; then
+    current_enabled="${BASH_REMATCH[1]}"
+  fi
+done < "$CONFIG"
+
+# Process last group
+if [[ -n "$current_name" ]]; then
+  process_group "$current_name" "$current_chat" "$current_tags" "$current_enabled"
+fi
+
+echo ""
+echo "=== Done ==="
+echo "  Success: $SUCCESS"
+echo "  Failed:  $FAILED"
+echo "  Skipped: $SKIPPED"

package/scripts/watch-anthropic-token.sh

@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+# Watch Claude Code credentials file and sync token to OpenClaw immediately on change.
+#
+# Replaces the 2-hour timer approach which missed token refreshes.
+# Claude Code auto-refreshes its OAuth token and writes to .credentials.json.
+# This script detects the write and syncs within seconds.
+#
+# Requires: inotifywait (from inotify-tools package)
+# Install: sudo apt install inotify-tools
+#
+# Run as systemd user service (not timer).
+
+set -euo pipefail
+
+CREDS="$HOME/.claude/.credentials.json"
+OPENCLAW_JSON="$HOME/.openclaw/openclaw.json"
+OPENCLAW_ENV="$HOME/.openclaw/.env"
+OVERRIDE_CONF="$HOME/.config/systemd/user/openclaw-gateway.service.d/override.conf"
+LOG_TAG="anthropic-token-watch"
+
+log() { echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] [$LOG_TAG] $*"; }
+
+sync_token() {
+    if [ ! -f "$CREDS" ]; then
+        log "ERROR: Claude credentials not found at $CREDS"
+        return 1
+    fi
+
+    # Read current token from Claude Code
+    local new_token
+    new_token=$(python3 -c "import json; print(json.load(open('$CREDS'))['claudeAiOauth']['accessToken'])" 2>/dev/null) || {
+        log "ERROR: Failed to read token from credentials"
+        return 1
+    }
+
+    local expires_in
+    expires_in=$(python3 -c "import json,time; print(f'{(json.load(open(\"$CREDS\"))[\"claudeAiOauth\"][\"expiresAt\"]/1000 - time.time())/3600:.1f}h')" 2>/dev/null || echo "unknown")
+
+    # Read current token from OpenClaw
+    local current_token
+    current_token=$(python3 -c "import json; print(json.load(open('$OPENCLAW_JSON'))['models']['providers']['anthropic']['apiKey'])" 2>/dev/null || echo "")
+
+    if [ "$new_token" = "$current_token" ]; then
+        log "Token unchanged (expires in $expires_in)"
+        return 0
+    fi
+
+    log "Token changed! Syncing... (new token expires in $expires_in)"
+
+    # 1. Update openclaw.json
+    python3 << PYEOF
+import json
+with open('$OPENCLAW_JSON') as f:
+    cfg = json.load(f)
+if 'anthropic' in cfg.get('models', {}).get('providers', {}):
+    cfg['models']['providers']['anthropic']['apiKey'] = '$new_token'
+    with open('$OPENCLAW_JSON', 'w') as f:
+        json.dump(cfg, f, indent=2)
+        f.write('\n')
+PYEOF
+    log "Updated openclaw.json"
+
+    # 2. Update .env
+    if grep -q "^ANTHROPIC_API_KEY=" "$OPENCLAW_ENV" 2>/dev/null; then
+        sed -i "s|^ANTHROPIC_API_KEY=.*|ANTHROPIC_API_KEY=$new_token|" "$OPENCLAW_ENV"
+    else
+        echo "ANTHROPIC_API_KEY=$new_token" >> "$OPENCLAW_ENV"
+    fi
+    log "Updated .env"
+
+    # 3. Update systemd override
+    if [ -f "$OVERRIDE_CONF" ]; then
+        local nvidia_key
+        nvidia_key=$(grep "NVIDIA_API_KEY=" "$OVERRIDE_CONF" 2>/dev/null | sed 's/.*NVIDIA_API_KEY=//' || true)
+        cat > "$OVERRIDE_CONF" << EOF
+[Unit]
+StartLimitIntervalSec=60
+StartLimitBurst=10
+
+[Service]
+RestartSec=10
+Environment=NVIDIA_API_KEY=${nvidia_key}
+Environment=ANTHROPIC_API_KEY=${new_token}
+EOF
+        log "Updated systemd override"
+    fi
+
+    # 4. Reload and restart gateway
+    systemctl --user daemon-reload 2>/dev/null || true
+    systemctl --user restart openclaw-gateway 2>/dev/null && log "Gateway restarted" || log "WARN: Gateway restart failed (may not be running as systemd service)"
+
+    # 5. Sync credentials to GPU box (.100) for skvoice service
+    scp -q "$CREDS" cbrd21@192.168.0.100:~/.claude/.credentials.json 2>/dev/null && log "Synced credentials to .100" || log "WARN: Failed to sync credentials to .100"
+
+    log "Sync complete. Token expires in $expires_in"
+}
+
+# Initial sync on startup
+log "Starting token watcher..."
+sync_token
+
+# Watch for changes to credentials file
+log "Watching $CREDS for changes..."
+while true; do
+    # inotifywait blocks until the file is modified, then we sync
+    inotifywait -q -e modify -e close_write -e moved_to "$(dirname "$CREDS")" --include "$(basename "$CREDS")" 2>/dev/null || {
+        # If inotifywait isn't available, fall back to polling every 30 seconds
+        log "WARN: inotifywait not available, falling back to 30s polling"
+        while true; do
+            sleep 30
+            sync_token
+        done
+    }
+    # Small delay to let Claude Code finish writing
+    sleep 2
+    sync_token
+done

package/src/skcapstone/__init__.py

@@ -11,7 +11,7 @@ import os
 import platform
 from pathlib import Path
 
-__version__ = "0.4.4"
+__version__ = "0.5.0"
 __author__ = "smilinTux"
 
 

package/src/skcapstone/_cli_monolith.py

@@ -3212,8 +3212,8 @@ def dashboard(home: str, port: int, no_open: bool):
         import webbrowser
         try:
             webbrowser.open(url)
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to open browser for dashboard: %s", exc)
 
     server = start_dashboard(home_path, port=port)
     try:
@@ -5353,8 +5353,8 @@ def agents_spawn(
                 prov_backend = DockerProvider()
             elif prov_type == ProviderType.PROXMOX:
                 prov_backend = ProxmoxProvider()
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to initialize provider backend for %s: %s", provider, exc)
 
     # Auto-classify for display
     detected_role, detected_model = classify_task(task)

package/src/skcapstone/api.py

@@ -828,23 +828,23 @@ async def get_dashboard(
                 "consciousness": m.consciousness.value if hasattr(m, "consciousness") else "",
                 "version": m.version,
             }
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to read agent identity from runtime manifest: %s", exc)
     if not agent:
         try:
             identity_path = config.home / "identity" / "identity.json"
             if identity_path.exists():
                 agent = json.loads(identity_path.read_text(encoding="utf-8"))
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to read identity.json for API status: %s", exc)
 
     # Consciousness stats
     c_stats: Dict[str, Any] = {}
     if consciousness:
         try:
             c_stats = dict(consciousness.stats)
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to read consciousness stats: %s", exc)
 
     # Recent conversations
     conversations: List[Dict[str, Any]] = []
@@ -862,8 +862,8 @@ async def get_dashboard(
                         "last": last.get("timestamp"),
                         "preview": preview,
                     })
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to list recent conversations for API status: %s", exc)
 
     daemon_summary = DaemonSummary(
         running=snap.get("running", True),
@@ -924,8 +924,8 @@ async def get_capstone(
             m = runtime.manifest
             agent = {"name": m.identity.name, "fingerprint": m.identity.fingerprint or ""}
             pillars = {k: v.value for k, v in m.pillar_summary.items()}
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to read agent pillars from runtime manifest: %s", exc)
 
     # Memory stats
     memory = MemorySummary()
@@ -940,8 +940,8 @@ async def get_capstone(
             long_term=ms.long_term,
             status=ms.status.value,
         )
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to collect memory stats for capstone API: %s", exc)
 
     # Coordination board
     board: Dict[str, Any] = {"summary": {}, "active": []}
@@ -970,16 +970,16 @@ async def get_capstone(
                 if v.status.value in ("in_progress", "claimed")
             ],
         }
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to collect coordination board data for capstone API: %s", exc)
 
     # Consciousness stats
     c_stats: Dict[str, Any] = {}
     if consciousness:
         try:
             c_stats = dict(consciousness.stats)
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to read consciousness stats for capstone API: %s", exc)
 
     return CapstoneResponse(
         agent=agent,
@@ -1027,8 +1027,8 @@ async def get_activity_stream(
         try:
             for chunk in _activity.get_history_encoded():
                 yield chunk
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to replay activity stream history: %s", exc)
         # Stream live events; yield keep-alive comments on timeout
         try:
             while True:
@@ -1100,8 +1100,8 @@ async def list_household_agents(
             if identity_path.exists():
                 try:
                     entry["identity"] = json.loads(identity_path.read_text(encoding="utf-8"))
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Failed to read identity for agent %s: %s", agent_name, exc)
 
             hb: Optional[Dict[str, Any]] = None
             hb_path = heartbeats_dir / f"{agent_name.lower()}.json"
@@ -1112,7 +1112,8 @@ async def list_household_agents(
                     hb["alive"] = alive
                     entry["heartbeat"] = hb
                     entry["status"] = hb.get("status", "unknown") if alive else "stale"
-                except Exception:
+                except Exception as exc:
+                    logger.warning("Failed to read heartbeat for agent %s: %s", agent_name, exc)
                     entry["status"] = "unknown"
             else:
                 entry["status"] = "no_heartbeat"
@@ -1174,8 +1175,8 @@ async def get_household_agent(
     if identity_path.exists():
         try:
             entry["identity"] = json.loads(identity_path.read_text(encoding="utf-8"))
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to read identity for agent %s: %s", name, exc)
 
     hb_path = config.shared_root / "heartbeats" / f"{name.lower()}.json"
     if hb_path.exists():
@@ -1185,8 +1186,8 @@ async def get_household_agent(
             hb["alive"] = alive
             entry["heartbeat"] = hb
             entry["status"] = hb.get("status", "unknown") if alive else "stale"
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to read heartbeat for agent %s: %s", name, exc)
 
     # Memory count
     memory_dir = agent_dir / "memory"
@@ -1249,8 +1250,8 @@ async def list_conversations(
                             last_message_preview=(last_content or "")[:120],
                         )
                     )
-            except Exception:
-                pass
+            except Exception as exc:
+                logger.warning("Failed to read conversation file %s: %s", cf, exc)
     return ConversationsResponse(conversations=conversations)
 
 
@@ -1534,8 +1535,8 @@ def _load_first_argocd_doc(path: Path) -> Optional[dict]:
                     "sync_policy": spec.get("syncPolicy", {}),
                     "manifest_file": path.name,
                 }
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to parse ArgoCD manifest %s: %s", path, exc)
     return None
 
 
@@ -1618,8 +1619,8 @@ def _get_argocd_status() -> dict:
                     "last_synced": (item_status.get("operationState") or {}).get("finishedAt"),
                 }
             source = "yaml+kubectl"
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("kubectl ArgoCD status query failed (using yaml only): %s", exc)
 
     # ── Merge and build output ───────────────────────────────────────────────
     apps = []
@@ -1767,8 +1768,8 @@ async def websocket_logs(
                 tail_lines = list(deque(fh, maxlen=50))
             for line in tail_lines:
                 await websocket.send_json({"type": "line", "line": line.rstrip("\n")})
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to replay log tail history over websocket: %s", exc)
 
     # Tail the log file and stream new lines
     try:
@@ -1783,8 +1784,8 @@ async def websocket_logs(
                             for ln in chunk.splitlines():
                                 await websocket.send_json({"type": "line", "line": ln})
                         offset = fh.tell()
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Log tail websocket read error: %s", exc)
             await asyncio.sleep(0.5)
     except WebSocketDisconnect:
         pass

package/src/skcapstone/auction.py

@@ -107,8 +107,8 @@ def _collect_local_bid(task_id: str, agent_name: str, shared_root: Path) -> Auct
         agent_file = board.load_agent(agent_name)
         if agent_file:
             claimed_count = len(agent_file.claimed_tasks)
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to read claimed task count for agent %s: %s", agent_name, exc)
 
     return AuctionBid(
         task_id=task_id,
@@ -283,8 +283,8 @@ class AuctionManager:
                     ttl_seconds=3600,
                     tags=["auction", "no_bidders"],
                 )
-            except Exception:
-                pass
+            except Exception as exc:
+                logger.warning("Failed to publish auction_no_bidders event for %s: %s", task_id, exc)
             return None
 
         winner_bid = min(record.bids, key=_load_score)
@@ -327,8 +327,8 @@ class AuctionManager:
                 ttl_seconds=3600,
                 tags=["auction", "resolved"],
             )
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to publish auction_resolved event for %s: %s", task_id, exc)
 
         # Notify activity stream
         try:
@@ -338,8 +338,8 @@ class AuctionManager:
                 "task.auction_resolved",
                 {"task_id": task_id, "winner": winner, "bids": len(record.bids)},
             )
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to push auction_resolved activity for %s: %s", task_id, exc)
 
         return winner
 

package/src/skcapstone/blueprint_registry.py

@@ -183,8 +183,8 @@ class BlueprintRegistryClient:
             error_body = ""
             try:
                 error_body = exc.read().decode("utf-8", errors="replace")
-            except Exception:
-                pass
+            except Exception as read_exc:
+                logger.debug("Failed to read error body from registry HTTP error: %s", read_exc)
             msg = f"Registry API error {exc.code} for {method} {path}"
             if error_body:
                 msg += f": {error_body[:500]}"

package/src/skcapstone/blueprints/builtins/itil-operations.yaml

@@ -0,0 +1,40 @@
+name: "ITIL Operations"
+slug: "itil-operations"
+version: "1.0.0"
+description: "ITIL service management — incident, problem, and change lifecycle with SLA monitoring and continuous improvement."
+icon: "🔄"
+author: "smilinTux"
+
+agents:
+  deming:
+    role: ops
+    model: reason
+    model_name: "deepseek-r1:32b"
+    description: "ITIL expert — incident triage, problem analysis, change management, SLA monitoring, and blameless postmortems."
+    vm_type: container
+    resources:
+      memory: "4g"
+      cores: 2
+      disk: "20g"
+    soul_blueprint: "souls/deming.yaml"
+    skills: [incident-management, problem-analysis, change-management, kedb, sla-monitoring, root-cause-analysis]
+
+default_provider: local
+estimated_cost: "$0 (local)"
+
+network:
+  mesh_vpn: tailscale
+  discovery: skref_registry
+
+storage:
+  skref_vault: "team-itil-ops"
+  memory_backend: filesystem
+  memory_sync: true
+
+coordination:
+  queen: lumina
+  pattern: supervisor
+  heartbeat: "5m"
+  escalation: chef
+
+tags: [ops, itil, incident-management, problem-analysis, change-management, sla-monitoring, continuous-improvement]