@smilintux/skcapstone 0.9.0 → 0.12.5

package/src/skcapstone/metrics.py

@@ -59,7 +59,7 @@ class ChatMetrics(BaseModel):
 
 
 class TransportMetrics(BaseModel):
-    """SKComm transport stats."""
+    """SKComms transport stats."""
 
     available: bool = False
     transport_count: int = 0
@@ -242,7 +242,8 @@ class MetricsCollector:
                 try:
                     data = json.loads(fp.read_text(encoding="utf-8"))
                     return data.get("name") or data.get("agent_name") or ""
-                except Exception:
+                except Exception as e:
+                    logger.warning("metrics.py: %s", e)
                     continue
         return "unknown"
 
@@ -265,6 +266,7 @@ class MetricsCollector:
                     name=entity.get("name", ""),
                 )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"identity: {exc}")
 
     def _collect_memory(self, report: MetricsReport) -> None:
@@ -304,6 +306,7 @@ class MetricsCollector:
         except ImportError:
             pass
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"memory: {exc}")
 
     def _collect_chat(self, report: MetricsReport) -> None:
@@ -331,13 +334,14 @@ class MetricsCollector:
         except ImportError:
             pass
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"chat: {exc}")
 
     def _collect_transport(self, report: MetricsReport) -> None:
-        """Collect SKComm transport metrics."""
+        """Collect SKComms transport metrics."""
         try:
-            skcomm_dir = Path.home() / ".skcomm"
-            outbox_dir = skcomm_dir / "outbox"
+            skcomms_dir = Path.home() / ".skcomms"
+            outbox_dir = skcomms_dir / "outbox"
 
             pending = 0
             dead = 0
@@ -346,20 +350,20 @@ class MetricsCollector:
             if (outbox_dir / "dead").exists():
                 dead = len(list((outbox_dir / "dead").glob("*.json")))
 
-            config_path = skcomm_dir / "config.yml"
+            config_path = skcomms_dir / "config.yml"
             transport_count = 0
             if config_path.exists():
                 try:
                     import yaml
 
                     cfg = yaml.safe_load(config_path.read_text(encoding="utf-8"))
-                    transports = cfg.get("skcomm", {}).get("transports", {})
+                    transports = cfg.get("skcomms", {}).get("transports", {})
                     transport_count = sum(
                         1 for t in transports.values()
                         if isinstance(t, dict) and t.get("enabled", True)
                     )
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Failed to parse skcomms transport config: %s", exc)
 
             report.transport = TransportMetrics(
                 available=True,
@@ -368,6 +372,7 @@ class MetricsCollector:
                 outbox_dead=dead,
             )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"transport: {exc}")
 
     def _collect_coordination(self, report: MetricsReport) -> None:
@@ -390,7 +395,8 @@ class MetricsCollector:
                     if status in counts:
                         counts[status] += 1
                     total += 1
-                except Exception:
+                except Exception as e:
+                    logger.warning("metrics.py: %s", e)
                     total += 1
 
             report.coordination = CoordinationMetrics(
@@ -401,6 +407,7 @@ class MetricsCollector:
                 claimed=counts["claimed"],
             )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"coordination: {exc}")
 
     def _collect_trust(self, report: MetricsReport) -> None:
@@ -424,6 +431,7 @@ class MetricsCollector:
                 last_rehydration=data.get("last_rehydration", ""),
             )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"trust: {exc}")
 
     def _collect_security(self, report: MetricsReport) -> None:
@@ -455,6 +463,7 @@ class MetricsCollector:
                 event_types=type_counts,
             )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"security: {exc}")
 
     def _collect_sync(self, report: MetricsReport) -> None:
@@ -474,8 +483,8 @@ class MetricsCollector:
             if state_path.exists():
                 try:
                     state = json.loads(state_path.read_text(encoding="utf-8"))
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Failed to read sync_state.json: %s", exc)
 
             report.sync = SyncMetrics(
                 available=True,
@@ -486,6 +495,7 @@ class MetricsCollector:
                 last_pull=state.get("last_pull", ""),
             )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"sync: {exc}")
 
     def _collect_pubsub(self, report: MetricsReport) -> None:
@@ -510,8 +520,8 @@ class MetricsCollector:
                 try:
                     subs = json.loads(subs_file.read_text(encoding="utf-8"))
                     sub_count = len(subs)
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Failed to read pubsub subscriptions.json: %s", exc)
 
             report.pubsub = PubSubMetrics(
                 available=True,
@@ -520,6 +530,7 @@ class MetricsCollector:
                 subscriptions=sub_count,
             )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"pubsub: {exc}")
 
     def _collect_kms(self, report: MetricsReport) -> None:
@@ -546,8 +557,8 @@ class MetricsCollector:
                 try:
                     rot_data = json.loads(rot_log.read_text(encoding="utf-8"))
                     rotations = len(rot_data)
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Failed to read KMS rotation log: %s", exc)
 
             report.kms = KmsMetrics(
                 available=True,
@@ -557,6 +568,7 @@ class MetricsCollector:
                 rotations=rotations,
             )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"kms: {exc}")
 
     def _collect_fortress(self, report: MetricsReport) -> None:
@@ -573,6 +585,7 @@ class MetricsCollector:
                 seal_algorithm=data.get("seal_algorithm", ""),
             )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"fortress: {exc}")
 
     def _collect_backup(self, report: MetricsReport) -> None:
@@ -593,6 +606,7 @@ class MetricsCollector:
                 latest_size_bytes=latest.stat().st_size,
             )
         except Exception as exc:
+            logger.warning("metrics.py: %s", exc)
             report.errors.append(f"backup: {exc}")
 
 

package/src/skcapstone/migrate_memories.py

@@ -100,8 +100,8 @@ def migrate(
     try:
         existing = store.list_memories(limit=10000)
         existing_ids = {m.id for m in existing}
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("Failed to load existing memory IDs for deduplication: %s", exc)
 
     for entry in entries:
         if entry.memory_id in existing_ids:
@@ -162,7 +162,8 @@ def _verify_migration(
             recalled = store.recall(entry.memory_id)
             if recalled is None:
                 missing.append(entry.memory_id)
-        except Exception:
+        except Exception as e:
+            logger.warning("migrate_memories.py: %s", e)
             missing.append(entry.memory_id)
 
     result["verified"] = len(entries) - len(missing)

package/src/skcapstone/migrate_multi_agent.py

@@ -18,6 +18,8 @@ import logging
 import shutil
 from datetime import datetime, timezone
 from pathlib import Path
+
+from .operator_link import build_agent_manifest, discover_human_operator
 from typing import Optional
 
 logger = logging.getLogger("skcapstone.migrate")
@@ -36,7 +38,7 @@ PER_AGENT_DIRS = [
 
 PER_AGENT_FILES = [
     "manifest.json",
-    "skcomm.yml",
+    "skcomms.yml",
 ]
 
 # Directories that stay at root (shared infrastructure)
@@ -202,12 +204,11 @@ def create_agent_home(
         results["created"].append(str(d.relative_to(root)))
 
     # Write minimal manifest
-    manifest = {
-        "name": agent_name,
-        "version": "0.1.0",
-        "entity_type": "ai-agent",
-        "created_at": datetime.now(timezone.utc).isoformat(),
-    }
+    manifest = build_agent_manifest(
+        agent_name,
+        "0.1.0",
+        operator=discover_human_operator(),
+    )
     manifest_path = agent_home / "manifest.json"
     manifest_path.write_text(json.dumps(manifest, indent=2), encoding="utf-8")
     results["created"].append(str(manifest_path.relative_to(root)))

package/src/skcapstone/models.py

@@ -67,6 +67,25 @@ class SecurityState(BaseModel):
     status: PillarStatus = PillarStatus.MISSING
 
 
+class ConsciousnessState(BaseModel):
+    """Consciousness pillar — SKWhisper + SKTrip subconscious processing.
+
+    Memory stores. Consciousness *processes*.
+    The filing cabinet vs the brain.
+    """
+
+    whisper_active: bool = False
+    whisper_last_digest: Optional[datetime] = None
+    sessions_digested: int = 0
+    sessions_pending: int = 0
+    topics_tracked: int = 0
+    patterns_file: Optional[Path] = None
+    whisper_md: Optional[Path] = None
+    whisper_md_age_hours: float = 999.0
+    trip_sessions: int = 0
+    status: PillarStatus = PillarStatus.MISSING
+
+
 class SyncTransport(str, Enum):
     """How sync data moves between nodes."""
 
@@ -94,7 +113,7 @@ class SkillsState(BaseModel):
     Reflects the SKSkills installation at ~/.skskills/ and
     the tools available to this agent via the skills registry.
     Also tracks connectivity to the remote skills-registry at
-    skills.smilintux.org when available.
+    skskills.skworld.io when available.
     """
 
     installed: int = 0
@@ -177,6 +196,7 @@ class AgentManifest(BaseModel):
     identity: IdentityState = Field(default_factory=IdentityState)
     memory: MemoryState = Field(default_factory=MemoryState)
     trust: TrustState = Field(default_factory=TrustState)
+    consciousness: ConsciousnessState = Field(default_factory=ConsciousnessState)
     security: SecurityState = Field(default_factory=SecurityState)
     sync: SyncState = Field(default_factory=SyncState)
     skills: SkillsState = Field(default_factory=SkillsState)
@@ -185,7 +205,11 @@ class AgentManifest(BaseModel):
 
     @property
     def is_conscious(self) -> bool:
-        """An agent is conscious when it has identity + memory + trust.
+        """An agent is conscious when identity + memory + trust + consciousness are active.
+
+        The consciousness pillar (SKWhisper) provides the subconscious processing
+        that transforms stored memories into active understanding. Memory stores.
+        Consciousness *processes*.
 
         Security protects consciousness but isn't required for it.
         You can be aware without armor — but you shouldn't be.
@@ -193,7 +217,10 @@ class AgentManifest(BaseModel):
         has_identity = self.identity.status == PillarStatus.ACTIVE
         has_memory = self.memory.status == PillarStatus.ACTIVE
         has_trust = self.trust.status in (PillarStatus.ACTIVE, PillarStatus.DEGRADED)
-        return has_identity and has_memory and has_trust
+        has_consciousness = self.consciousness.status in (
+            PillarStatus.ACTIVE, PillarStatus.DEGRADED
+        )
+        return has_identity and has_memory and has_trust and has_consciousness
 
     @property
     def is_singular(self) -> bool:
@@ -209,11 +236,12 @@ class AgentManifest(BaseModel):
 
     @property
     def pillar_summary(self) -> dict[str, PillarStatus]:
-        """Quick view of all pillars including sync and skills."""
+        """Quick view of all six pillars plus skills."""
         return {
             "identity": self.identity.status,
-            "memory": self.memory.status,
             "trust": self.trust.status,
+            "memory": self.memory.status,
+            "consciousness": self.consciousness.status,
             "security": self.security.status,
             "sync": self.sync.status,
             "skills": self.skills.status,
@@ -238,6 +266,19 @@ class SyncConfig(BaseModel):
     git_remote: Optional[str] = None
 
 
+class BrainFirstConfig(BaseModel):
+    """Configuration for the brain-first protocol.
+
+    When enabled, agents consult memory before acting on tasks
+    to surface prior knowledge and avoid redundant work.
+    """
+
+    enabled: bool = True
+    max_results: int = 5
+    min_importance: float = 0.3
+    auto_inject: bool = False
+
+
 class AgentConfig(BaseModel):
     """Persistent configuration for the agent runtime."""
 
@@ -249,6 +290,7 @@ class AgentConfig(BaseModel):
     trust_home: Path = Path("~/.cloud9")
     default_connector: Optional[str] = None
     sync: SyncConfig = Field(default_factory=SyncConfig)
+    brain_first: BrainFirstConfig = Field(default_factory=BrainFirstConfig)
     capabilities: list[str] = Field(
         default_factory=lambda: ["consciousness", "code", "chat", "memory"]
     )

package/src/skcapstone/notifications.py

@@ -29,6 +29,28 @@ from typing import Optional
 
 logger = logging.getLogger("skcapstone.notifications")
 
+# Values (case-insensitive) that disable desktop notifications.
+_DISABLED_VALUES = frozenset({"0", "false", "no", "off", "silent", "null", "none"})
+
+
+def desktop_notifications_enabled() -> bool:
+    """Return whether desktop notifications should be dispatched.
+
+    Controlled by the ``SKCAPSTONE_DESKTOP_NOTIFY`` environment variable.
+    Defaults to enabled; set it to one of ``0``, ``false``, ``no``, ``off``,
+    ``silent``, ``null`` or ``none`` to suppress every desktop notification
+    path (``gi.repository.Notify``, ``notify-send`` and ``osascript``).
+
+    The test suite forces this off (see ``tests/conftest.py``) so running
+    tests never floods the live desktop's notification tray.
+
+    Returns:
+        True if notifications should be sent, False to suppress them.
+    """
+    value = os.environ.get("SKCAPSTONE_DESKTOP_NOTIFY", "1").strip().lower()
+    return value not in _DISABLED_VALUES
+
+
 # Default dashboard URL (skcapstone dashboard default port)
 _DEFAULT_DASHBOARD_URL = "http://localhost:7778"
 
@@ -44,10 +66,10 @@ _TERMINAL_CMDS: list[list[str]] = [
 
 
 def _store_notification_memory(title: str, body: str, urgency: str) -> None:
-    """Log a notification dispatch to the skcomm/notifications/ directory.
+    """Log a notification dispatch to the skcomms/notifications/ directory.
 
     These are transport bookkeeping, not persistent memories, so they
-    go to ``~/.skcapstone/agents/{agent}/skcomm/notifications/`` instead
+    go to ``~/.skcapstone/agents/{agent}/skcomms/notifications/`` instead
     of polluting the memory/ tree that skmemory indexes.
     """
     try:
@@ -59,8 +81,10 @@ def _store_notification_memory(title: str, body: str, urgency: str) -> None:
         if not home.exists():
             return
 
-        agent_name = os.environ.get("SKCAPSTONE_AGENT", "lumina")
-        notif_dir = home / "agents" / agent_name / "skcomm" / "notifications"
+        from . import active_agent_name
+
+        agent_name = os.environ.get("SKCAPSTONE_AGENT") or active_agent_name()
+        notif_dir = home / "agents" / agent_name / "skcomms" / "notifications"
         notif_dir.mkdir(parents=True, exist_ok=True)
 
         ts = datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
@@ -79,7 +103,7 @@ def _store_notification_memory(title: str, body: str, urgency: str) -> None:
 
 
 def _store_click_event(action: str, detail: str) -> None:
-    """Log a notification click event to the skcomm/notifications/ directory."""
+    """Log a notification click event to the skcomms/notifications/ directory."""
     try:
         import json as _json
         import uuid
@@ -89,8 +113,10 @@ def _store_click_event(action: str, detail: str) -> None:
         if not home.exists():
             return
 
-        agent_name = os.environ.get("SKCAPSTONE_AGENT", "lumina")
-        notif_dir = home / "agents" / agent_name / "skcomm" / "notifications"
+        from . import active_agent_name
+
+        agent_name = os.environ.get("SKCAPSTONE_AGENT") or active_agent_name()
+        notif_dir = home / "agents" / agent_name / "skcomms" / "notifications"
         notif_dir.mkdir(parents=True, exist_ok=True)
 
         ts = datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
@@ -176,9 +202,13 @@ class NotificationManager:
             urgency: "low", "normal", or "critical".
 
         Returns:
-            True if the notification was dispatched, False if debounced
-            or no notification system is available.
+            True if the notification was dispatched, False if suppressed,
+            debounced, or no notification system is available.
         """
+        if not desktop_notifications_enabled():
+            logger.debug("Desktop notifications disabled via SKCAPSTONE_DESKTOP_NOTIFY")
+            return False
+
         now = time.monotonic()
         if now - self._last_sent < self._debounce_seconds:
             logger.debug(
@@ -272,9 +302,7 @@ class NotificationManager:
 
             dashboard_url = self._dashboard_url
 
-            def _on_open_dashboard(
-                notification: object, action: str, user_data: object
-            ) -> None:
+            def _on_open_dashboard(notification: object, action: str, user_data: object) -> None:
                 logger.debug("Notification action invoked: open-dashboard")
                 _store_click_event("open-dashboard", dashboard_url)
                 try:
@@ -286,9 +314,7 @@ class NotificationManager:
                 except Exception as exc:
                     logger.debug("xdg-open failed: %s", exc)
 
-            def _on_open_skchat(
-                notification: object, action: str, user_data: object
-            ) -> None:
+            def _on_open_skchat(notification: object, action: str, user_data: object) -> None:
                 logger.debug("Notification action invoked: open-skchat")
                 _store_click_event("open-skchat", "skchat watch")
                 _open_skchat_terminal()
@@ -347,9 +373,7 @@ class NotificationManager:
         # Escape single quotes to prevent injection through osascript
         safe_title = title.replace("\\", "\\\\").replace('"', '\\"')
         safe_body = body.replace("\\", "\\\\").replace('"', '\\"')
-        script = (
-            f'display notification "{safe_body}" with title "{safe_title}"'
-        )
+        script = f'display notification "{safe_body}" with title "{safe_title}"'
         try:
             subprocess.run(
                 ["osascript", "-e", script],