@smilintux/skcapstone 0.10.0 → 0.12.5

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],