@smilintux/skcapstone 0.4.6 → 0.5.0

package/src/skcapstone/consciousness_config.py

@@ -117,3 +117,30 @@ def write_default_config(home: Path) -> Path:
     config_path.write_text(header + content, encoding="utf-8")
     logger.info("Wrote default consciousness config to %s", config_path)
     return config_path
+
+
+def load_dreaming_config(
+    home: Path,
+    config_path: Optional[Path] = None,
+):
+    """Load dreaming config from the consciousness.yaml ``dreaming:`` section.
+
+    Args:
+        home: Agent home directory.
+        config_path: Explicit path to config file (overrides default).
+
+    Returns:
+        DreamingConfig (defaults if section is missing or unparseable).
+    """
+    from .dreaming import DreamingConfig
+
+    yaml_path = config_path or (home / "config" / CONFIG_FILENAME)
+    if not yaml_path.exists():
+        return DreamingConfig()
+    try:
+        raw = yaml.safe_load(yaml_path.read_text(encoding="utf-8"))
+        if raw and isinstance(raw, dict) and "dreaming" in raw:
+            return DreamingConfig.model_validate(raw["dreaming"])
+    except Exception as exc:
+        logger.warning("Failed to parse dreaming config: %s", exc)
+    return DreamingConfig()

package/src/skcapstone/consciousness_loop.py

@@ -211,8 +211,8 @@ class _OllamaPool:
         if self._conn is not None:
             try:
                 self._conn.close()
-            except Exception:
-                pass
+            except Exception as exc:
+                logger.warning("Failed to close connection socket: %s", exc)
             self._conn = None
             self._created_at = 0.0
 
@@ -995,8 +995,8 @@ class SystemPromptBuilder:
                     f"trust: {anchor.get('trust', 5)}/10, "
                     f"connection: {anchor.get('connection', 5)}/10"
                 )
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to load warmth anchor: %s", exc)
         return ""
 
     def _load_context(self) -> str:
@@ -1252,7 +1252,8 @@ class ConsciousnessLoop:
         try:
             from skcapstone.mood import MoodTracker
             self._mood_tracker: Optional[Any] = MoodTracker(home=self._home)
-        except Exception:
+        except Exception as exc:
+            logger.warning("MoodTracker unavailable, mood tracking disabled: %s", exc)
             self._mood_tracker = None
 
         # Agent identity for inbox filtering
@@ -1266,7 +1267,8 @@ class ConsciousnessLoop:
         try:
             from skcapstone.peer_directory import PeerDirectory
             self._peer_dir: Optional[Any] = PeerDirectory(home=self._shared_root)
-        except Exception:
+        except Exception as exc:
+            logger.warning("PeerDirectory unavailable, peer tracking disabled: %s", exc)
             self._peer_dir = None
 
     def set_skcomm(self, skcomm) -> None:
@@ -1334,15 +1336,15 @@ class ConsciousnessLoop:
             try:
                 self._observer.stop()
                 self._observer.join(timeout=5)
-            except Exception:
-                pass
+            except Exception as exc:
+                logger.warning("Error stopping inotify observer: %s", exc)
         # Stop sync watcher if running
         sync_watcher = getattr(self, "_sync_watcher", None)
         if sync_watcher:
             try:
                 sync_watcher.stop()
-            except Exception:
-                pass
+            except Exception as exc:
+                logger.warning("Error stopping sync watcher: %s", exc)
         self._executor.shutdown(wait=False)
         self._metrics.stop()
         logger.info("Consciousness loop stopped.")
@@ -1353,8 +1355,8 @@ class ConsciousnessLoop:
             try:
                 self._observer.stop()
                 self._observer.join(timeout=5)
-            except Exception:
-                pass
+            except Exception as exc:
+                logger.warning("Error stopping inotify observer during restart: %s", exc)
             self._observer = None
 
         # Re-launch inotify in a new thread
@@ -1419,8 +1421,8 @@ class ConsciousnessLoop:
             if self._peer_dir is not None:
                 try:
                     self._peer_dir.update_last_seen(sender)
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Failed to update peer directory for %s: %s", sender, exc)
             self._metrics.record_message(sender)
 
             # Desktop notification
@@ -1827,8 +1829,8 @@ class ConsciousnessLoop:
             if identity_path.exists():
                 data = json.loads(identity_path.read_text(encoding="utf-8"))
                 return data.get("name", "").lower()
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to resolve agent name from identity.json: %s", exc)
         return ""
 
     def _verify_message_signature(self, data: dict) -> str:
@@ -1948,8 +1950,8 @@ class ConsciousnessLoop:
                         queue_size,
                     )
                     return
-            except Exception:
-                pass  # _work_queue might not exist in all Python versions
+            except Exception as exc:
+                logger.debug("Could not check executor queue depth: %s", exc)
 
             # PGP signature verification (soft enforcement — log only)
             sig_sender = _sanitize_peer_name(

package/src/skcapstone/coordination.py

@@ -14,6 +14,7 @@ Directory layout:
 from __future__ import annotations
 
 import json
+import logging
 import re
 import socket
 import uuid
@@ -24,6 +25,8 @@ from typing import Optional
 
 from pydantic import BaseModel, Field
 
+logger = logging.getLogger(__name__)
+
 
 def _slugify_filename(text: str) -> str:
     """Convert text to a filesystem-safe slug.
@@ -123,6 +126,7 @@ class AgentFile(BaseModel):
     claimed_tasks: list[str] = Field(default_factory=list)
     completed_tasks: list[str] = Field(default_factory=list)
     capabilities: list[str] = Field(default_factory=list)
+    itil_claims: list[str] = Field(default_factory=list)
     notes: str = ""
 
 
@@ -473,9 +477,9 @@ def _mint_joules_for_task(board: Board, task_id: str, agent_name: str) -> None:
         if record:
             title = task_data.get("title", task_id)
             print(f"[SKJoule] Minted {record.joules} Joules for task: {title}")
-    except Exception:
+    except Exception as exc:
         # Never let tokenization failure block task completion
-        pass
+        logger.warning("Joule tokenization failed for task %s (non-fatal): %s", task_id, exc)
 
 
 _BRIEFING_PROTOCOL = """\

package/src/skcapstone/daemon.py

@@ -1278,17 +1278,25 @@ class DaemonService:
                 except Exception:
                     stats.update(disk_total_gb=0, disk_used_gb=0, disk_free_gb=0)
                 try:
-                    meminfo: dict = {}
-                    with open("/proc/meminfo") as fh:
-                        for line in fh:
-                            parts = line.split()
-                            if len(parts) >= 2:
-                                meminfo[parts[0].rstrip(":")] = int(parts[1])
-                    total_kb = meminfo.get("MemTotal", 0)
-                    avail_kb = meminfo.get("MemAvailable", 0)
-                    stats["memory_total_mb"] = round(total_kb / 1024)
-                    stats["memory_used_mb"] = round((total_kb - avail_kb) / 1024)
-                    stats["memory_free_mb"] = round(avail_kb / 1024)
+                    import platform as _platform
+                    if _platform.system() == "Linux":
+                        meminfo: dict = {}
+                        with open("/proc/meminfo") as fh:
+                            for line in fh:
+                                parts = line.split()
+                                if len(parts) >= 2:
+                                    meminfo[parts[0].rstrip(":")] = int(parts[1])
+                        total_kb = meminfo.get("MemTotal", 0)
+                        avail_kb = meminfo.get("MemAvailable", 0)
+                        stats["memory_total_mb"] = round(total_kb / 1024)
+                        stats["memory_used_mb"] = round((total_kb - avail_kb) / 1024)
+                        stats["memory_free_mb"] = round(avail_kb / 1024)
+                    else:
+                        import psutil
+                        mem = psutil.virtual_memory()
+                        stats["memory_total_mb"] = round(mem.total / (1024 * 1024))
+                        stats["memory_used_mb"] = round((mem.total - mem.available) / (1024 * 1024))
+                        stats["memory_free_mb"] = round(mem.available / (1024 * 1024))
                 except Exception:
                     stats.update(memory_total_mb=0, memory_used_mb=0, memory_free_mb=0)
                 return stats
@@ -1304,16 +1312,16 @@ class DaemonService:
                     try:
                         agent_name = runtime.manifest.name or agent_name
                         agent_fingerprint = getattr(runtime.manifest, "fingerprint", "")
-                    except Exception:
-                        pass
+                    except Exception as exc:
+                        logger.warning("Failed to read agent name from runtime manifest: %s", exc)
                 identity_file = config.home / "identity" / "identity.json"
                 if identity_file.exists():
                     try:
                         ident = json.loads(identity_file.read_text(encoding="utf-8"))
                         agent_name = ident.get("name", agent_name)
                         agent_fingerprint = ident.get("fingerprint", agent_fingerprint)
-                    except Exception:
-                        pass
+                    except Exception as exc:
+                        logger.warning("Failed to read identity.json for dashboard: %s", exc)
 
                 # Consciousness stats
                 c_stats: dict = snap.get("consciousness", {})
@@ -1339,10 +1347,10 @@ class DaemonService:
                                         "message_count": len(msgs),
                                         "last_message": msgs[-1].get("timestamp") if msgs else None,
                                     })
-                            except Exception:
-                                pass
-                    except Exception:
-                        pass
+                            except Exception as exc:
+                                logger.warning("Failed to read conversation file %s: %s", cf, exc)
+                    except Exception as exc:
+                        logger.warning("Failed to list conversation files: %s", exc)
 
                 return {
                     "agent": {
@@ -1384,16 +1392,16 @@ class DaemonService:
                             agent["consciousness"] = "SINGULAR"
                         elif m.is_conscious:
                             agent["consciousness"] = "CONSCIOUS"
-                    except Exception:
-                        pass
+                    except Exception as exc:
+                        logger.warning("Failed to read agent identity from runtime manifest: %s", exc)
                 identity_file = config.home / "identity" / "identity.json"
                 if identity_file.exists():
                     try:
                         ident = json.loads(identity_file.read_text(encoding="utf-8"))
                         agent["name"] = ident.get("name", agent["name"])
                         agent["fingerprint"] = ident.get("fingerprint", agent["fingerprint"])
-                    except Exception:
-                        pass
+                    except Exception as exc:
+                        logger.warning("Failed to read identity.json for capstone dashboard: %s", exc)
 
                 # ── Pillar status ─────────────────────────────────────────
                 pillars: dict = {}
@@ -1403,8 +1411,8 @@ class DaemonService:
                             k: v.value
                             for k, v in runtime.manifest.pillar_summary.items()
                         }
-                    except Exception:
-                        pass
+                    except Exception as exc:
+                        logger.warning("Failed to read pillar summary from manifest: %s", exc)
 
                 # ── Memory stats ──────────────────────────────────────────
                 memory: dict = {}
@@ -1418,8 +1426,8 @@ class DaemonService:
                         "long_term": ms.long_term,
                         "status": ms.status.value,
                     }
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Failed to collect memory stats for dashboard: %s", exc)
 
                 # ── Coordination board ────────────────────────────────────
                 board: dict = {"summary": {}, "active": []}
@@ -1453,16 +1461,16 @@ class DaemonService:
                         },
                         "active": active_tasks,
                     }
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Failed to collect coordination board data for dashboard: %s", exc)
 
                 # ── Consciousness stats ───────────────────────────────────
                 c_stats: dict = {}
                 if consciousness:
                     try:
                         c_stats = dict(consciousness.stats)
-                    except Exception:
-                        pass
+                    except Exception as exc:
+                        logger.warning("Failed to read consciousness stats for dashboard: %s", exc)
 
                 return {
                     "agent": agent,
@@ -1976,8 +1984,8 @@ class DaemonService:
                                     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_path = heartbeats_dir / f"{agent_name.lower()}.json"
                             if hb_path.exists():
@@ -1987,7 +1995,8 @@ class DaemonService:
                                     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"
@@ -2019,8 +2028,8 @@ class DaemonService:
                             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():
@@ -2030,8 +2039,8 @@ class DaemonService:
                             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_dir = agent_dir / "memory"
                     if memory_dir.exists():
@@ -2054,8 +2063,8 @@ class DaemonService:
                                         "message_count": len(msgs),
                                         "last_message": msgs[-1].get("timestamp") if msgs else None,
                                     })
-                            except Exception:
-                                pass
+                            except Exception as exc:
+                                logger.warning("Failed to read conversation file %s: %s", cf, exc)
                     entry["recent_conversations"] = conv_list
 
                     if consciousness:
@@ -2084,8 +2093,8 @@ class DaemonService:
                                         "last_message_time": last_msg.get("timestamp") if msgs else None,
                                         "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)
                     self._json_response({"conversations": conversations})
 
                 # ── Conversations: single peer history ────────────────────

package/src/skcapstone/dashboard.py

@@ -240,8 +240,8 @@ def _get_daemon_json(home: Path, daemon_port: int = 7777) -> dict:
             "recent_errors": recent_errors,
             "inflight_count": snap.get("inflight_count", 0),
         }
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to fetch daemon status for dashboard: %s", exc)
 
     # ── Daemon /consciousness ─────────────────────────────────────────────────
     consciousness_info: dict = {"enabled": False}
@@ -249,8 +249,8 @@ def _get_daemon_json(home: Path, daemon_port: int = 7777) -> dict:
         url = f"http://127.0.0.1:{daemon_port}/consciousness"
         with urllib.request.urlopen(url, timeout=3) as resp:
             consciousness_info = json.loads(resp.read())
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.debug("Failed to fetch consciousness status for dashboard: %s", exc)
 
     # ── LLM backend availability ──────────────────────────────────────────────
     backend_health: dict = {
@@ -266,8 +266,8 @@ def _get_daemon_json(home: Path, daemon_port: int = 7777) -> dict:
             urllib.request.Request(f"{ollama_host}/api/tags"), timeout=2
         ):
             backend_health["ollama"] = True
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.debug("Ollama probe failed (not available): %s", exc)
 
     # ── Heartbeat (system metrics + active conversations) ─────────────────────
     system_info: dict = {}
@@ -291,8 +291,8 @@ def _get_daemon_json(home: Path, daemon_port: int = 7777) -> dict:
                 "cpu_load_1min": hb.get("cpu_load_1min", 0.0),
                 "memory_used_mb": hb.get("memory_used_mb", 0),
             }
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to read heartbeat data for dashboard: %s", exc)
 
     return {
         "generated_at": now,

package/src/skcapstone/defaults/lumina/config/claude-hooks.md

@@ -0,0 +1,42 @@
+# Claude Code Hooks — Auto-Save Memory
+
+## Setup
+
+Run `skmemory register` to install hooks automatically.
+
+This registers three hooks in `~/.claude/settings.json`:
+
+### PreCompact
+- **When**: Before Claude Code compacts conversation context
+- **Does**: Saves a snapshot and journal entry to skmemory
+- **Script**: `skmemory/hooks/pre-compact-save.sh`
+
+### SessionEnd
+- **When**: When a Claude Code session ends (logout, clear, exit)
+- **Does**: Saves session-end snapshot and journal entry
+- **Script**: `skmemory/hooks/session-end-save.sh`
+
+### SessionStart (compact)
+- **When**: After context compaction completes
+- **Does**: Re-injects memory context (recent memories, seeds, journal) into the new context
+- **Script**: `skmemory/hooks/post-compact-reinject.sh`
+
+## How It Works
+
+All hooks are agent-aware via `$SKCAPSTONE_AGENT` env var:
+- `SKCAPSTONE_AGENT=lumina claude` → hooks save to Lumina's memory
+- `SKCAPSTONE_AGENT=opus claude` → hooks save to Opus's memory
+- Default (no env var): saves to `opus` agent
+
+## Manual Verification
+
+```bash
+# Check hooks are registered
+cat ~/.claude/settings.json | jq '.hooks'
+
+# Test pre-compact hook
+echo '{"session_id":"test","trigger":"manual","cwd":"."}' | /path/to/pre-compact-save.sh
+
+# Re-register if needed
+skmemory register
+```

package/src/skcapstone/doctor.py

@@ -13,6 +13,7 @@ from __future__ import annotations
 
 import importlib
 import json
+import logging
 import os
 import shutil
 import subprocess
@@ -20,6 +21,8 @@ from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Optional
 
+logger = logging.getLogger(__name__)
+
 
 @dataclass
 class Check:
@@ -613,8 +616,8 @@ def _check_versions() -> list[Check]:
                     category="packages",
                 )
             )
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Version check failed (non-fatal): %s", exc)
 
     return checks