@smilintux/skcapstone 0.10.0 → 0.12.5

package/src/skcapstone/chat.py

@@ -2,7 +2,7 @@
 Interactive agent-to-agent chat for the sovereign terminal.
 
 Provides a real-time terminal chat experience between agents using
-SKChat for message models and SKComm for transport. Works from any
+SKChat for message models and SKComms for transport. Works from any
 terminal on any platform — no IDE dependency.
 
 Usage:
@@ -52,7 +52,7 @@ _TEXT_SUFFIXES = {
 class AgentChat:
     """Interactive chat engine for sovereign agent communication.
 
-    Wraps SKChat models and SKComm transport into a simple
+    Wraps SKChat models and SKComms transport into a simple
     send/receive/poll interface suitable for terminal use.
 
     Args:
@@ -71,7 +71,7 @@ class AgentChat:
     # ------------------------------------------------------------------
 
     def _ensure_comm(self) -> bool:
-        """Lazily initialize the SKComm engine.
+        """Lazily initialize the SKComms engine.
 
         Returns:
             bool: True if communication layer is available.
@@ -80,15 +80,15 @@ class AgentChat:
             return True
 
         try:
-            from skcomm.core import SKComm
+            from skcomms.core import SKComms
 
-            self._comm = SKComm.from_config()
+            self._comm = SKComms.from_config()
             return len(self._comm.router.transports) > 0
         except ImportError:
-            logger.info("skcomm not installed")
+            logger.info("skcomms not installed")
             return False
         except Exception as exc:
-            logger.info("SKComm init failed: %s", exc)
+            logger.info("SKComms init failed: %s", exc)
             return False
 
     def _ensure_history(self):
@@ -123,7 +123,7 @@ class AgentChat:
         """Send a message to a peer agent.
 
         Stores locally in SKMemory-backed history and delivers via
-        SKComm if transports are available.
+        SKComms if transports are available.
 
         Args:
             recipient: Peer agent name or CapAuth identity.
@@ -162,6 +162,7 @@ class AgentChat:
                         result["delivered"] = True
                         result["transport"] = getattr(report, "successful_transport", None)
                 except Exception as exc:
+                    logger.warning("chat.py: %s", exc)
                     result["error"] = str(exc)
 
         except ImportError as exc:
@@ -204,8 +205,8 @@ class AgentChat:
                                     thread_id=msg_dict.get("thread_id"),
                                 )
                                 history.store_message(chat_msg)
-                            except Exception:
-                                pass
+                            except Exception as exc:
+                                logger.warning("Failed to store received message in history: %s", exc)
             except Exception as exc:
                 logger.warning("Receive error: %s", exc)
 
@@ -226,14 +227,16 @@ class AgentChat:
 
         try:
             return history.search_messages(self.identity, limit=limit)
-        except Exception:
+        except Exception as e:
+            logger.warning("chat.py: %s", e)
             try:
                 memories = history._store.list_memories(
                     tags=["skchat:message"],
                     limit=limit,
                 )
                 return [history._memory_to_chat_dict(m) for m in memories]
-            except Exception:
+            except Exception as e:
+                logger.warning("chat.py: %s", e)
                 return []
 
     def forward(
@@ -246,7 +249,7 @@ class AgentChat:
 
         Wraps the original message in a forward envelope that records the
         original sender and timestamp, then delivers it to target_peer via
-        SKComm and stores it locally in history.
+        SKComms and stores it locally in history.
 
         Args:
             original_msg: Original message dict (from inbox or receive).
@@ -298,6 +301,7 @@ class AgentChat:
                 history.store_message(fwd_msg)
                 result["stored"] = True
             except Exception as exc:
+                logger.warning("chat.py: %s", exc)
                 result["error"] = str(exc)
 
         if self._ensure_comm():
@@ -311,6 +315,7 @@ class AgentChat:
                     result["delivered"] = True
                     result["transport"] = getattr(report, "successful_transport", None)
             except Exception as exc:
+                logger.warning("chat.py: %s", exc)
                 result["error"] = str(exc)
 
         return result
@@ -410,8 +415,8 @@ class AgentChat:
                             state["last_recv_thread"] = recv_thread
                         display = _format_content(content)
                         print(f"\n  \033[32m{sender}\033[0m \033[2m[{ts}]\033[0m  {display}\n")
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Chat poll loop error: %s", exc)
 
         # Print header
         tr_label = "✓ connected" if transport_ok else "✗ local-only"
@@ -629,7 +634,7 @@ class AgentChat:
 # ---------------------------------------------------------------------------
 
 def _pack_chat_payload(msg) -> str:
-    """Serialize a ChatMessage for SKComm transport.
+    """Serialize a ChatMessage for SKComms transport.
 
     Args:
         msg: ChatMessage instance.
@@ -649,7 +654,7 @@ def _pack_chat_payload(msg) -> str:
 
 
 def _unpack_chat_payload(payload: str, sender: str, recipient: str) -> dict:
-    """Deserialize a chat payload from SKComm.
+    """Deserialize a chat payload from SKComms.
 
     Falls back to plain text if not structured JSON.
 

package/src/skcapstone/cli/__init__.py

@@ -19,7 +19,7 @@ from .. import __version__
 @click.group()
 @click.version_option(version=__version__, prog_name="skcapstone")
 @click.option(
-    "--agent", envvar="SKCAPSTONE_AGENT", default="",
+    "--agent", envvar="SKAGENT", default="",
     help="Agent name — resolves home to {root}/agents/{name}/",
 )
 @click.pass_context
@@ -52,6 +52,7 @@ from .completions import register_completions_commands
 from .peer import register_peer_commands
 from .backup import register_backup_commands
 from .chat import register_chat_commands
+from .record_cmd import register_record_commands
 from .anchor import register_anchor_commands
 from .session import register_session_commands
 from .context_cmd import register_context_commands
@@ -91,6 +92,9 @@ from .skseed import register_skseed_commands
 from .service_cmd import register_service_commands
 from .telegram import register_telegram_commands
 from .joule_cmd import register_joule_commands
+from .alerts import register_alerts_commands
+from .scheduler_cmd import register_scheduler_commands
+from .identity_cmd import register_identity_commands
 
 register_setup_commands(main)
 register_shell_commands(main)
@@ -106,6 +110,7 @@ register_completions_commands(main)
 register_peer_commands(main)
 register_backup_commands(main)
 register_chat_commands(main)
+register_record_commands(main)
 register_anchor_commands(main)
 register_session_commands(main)
 register_context_commands(main)
@@ -144,3 +149,6 @@ register_skseed_commands(main)
 register_service_commands(main)
 register_telegram_commands(main)
 register_joule_commands(main)
+register_alerts_commands(main)
+register_scheduler_commands(main)
+register_identity_commands(main)

package/src/skcapstone/cli/_common.py

@@ -58,6 +58,7 @@ def apply_agent_override(agent: str) -> None:
     """
     if agent:
         _pkg.SKCAPSTONE_AGENT = agent
+        os.environ["SKAGENT"] = agent
         os.environ["SKCAPSTONE_AGENT"] = agent
 
 

package/src/skcapstone/cli/agents_spawner.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import logging
 from pathlib import Path
 from typing import Optional
 
@@ -12,6 +13,8 @@ from ._common import AGENT_HOME, console
 from rich.panel import Panel
 from rich.table import Table
 
+logger = logging.getLogger(__name__)
+
 
 def _resolve_provider_backend(provider: Optional[str], home_path: Path):
     """Resolve provider string to backend object and ProviderType.
@@ -37,8 +40,8 @@ def _resolve_provider_backend(provider: Optional[str], home_path: Path):
                 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)
     return prov_backend, prov_type
 
 

package/src/skcapstone/cli/alerts.py

@@ -25,15 +25,21 @@ except ImportError:  # pragma: no cover
 # Constants
 # ---------------------------------------------------------------------------
 
-#: Default topics the alerts command subscribes to.
+#: Default topics the alerts command subscribes to. The trailing ``*.<sev>``
+#: wildcards surface alerts published by any sk* service via ``sdk.alert()``,
+#: which follows the ``<service>.<severity>`` topic convention (e.g.
+#: ``skmemory.error``, ``sksecurity.critical``).
 DEFAULT_TOPICS: tuple[str, ...] = (
     "agent.critical",
     "coord.task_failed",
     "consciousness.error",
     "pillar.degraded",
+    "*.critical",
+    "*.error",
+    "*.warn",
 )
 
-#: Rich markup styles per topic prefix (longest match wins).
+#: Rich markup styles per exact topic name.
 _TOPIC_STYLE: dict[str, str] = {
     "agent.critical":     "bold red",
     "coord.task_failed":  "red",
@@ -41,6 +47,15 @@ _TOPIC_STYLE: dict[str, str] = {
     "pillar.degraded":    "yellow",
 }
 
+#: Rich markup styles by severity suffix — used for ``<service>.<severity>``
+#: consumer topics with no exact match in ``_TOPIC_STYLE``.
+_SEVERITY_STYLE: dict[str, str] = {
+    "critical": "bold red",
+    "error":    "red",
+    "warn":     "yellow",
+    "info":     "cyan",
+}
+
 #: Default polling interval in seconds.
 DEFAULT_INTERVAL: float = 1.0
 
@@ -56,9 +71,15 @@ def _style_for_topic(topic: str) -> str:
         topic: Full topic name (e.g. ``"agent.critical"``).
 
     Returns:
-        Rich style string for the topic, or ``"dim"`` if unrecognised.
+        Rich style string for the topic. Exact matches win; otherwise the
+        topic's ``<service>.<severity>`` suffix is used (e.g. ``skmemory.error``
+        → the ``error`` style). Falls back to ``"dim"`` if unrecognised.
     """
-    return _TOPIC_STYLE.get(topic, "dim")
+    exact = _TOPIC_STYLE.get(topic)
+    if exact:
+        return exact
+    suffix = topic.rsplit(".", 1)[-1]
+    return _SEVERITY_STYLE.get(suffix, "dim")
 
 
 def _format_payload(payload: dict) -> str:

package/src/skcapstone/cli/bench.py

@@ -1,7 +1,7 @@
-"""Benchmark SKComm transport throughput and latency.
+"""Benchmark SKComms transport throughput and latency.
 
 Sends N messages of a configurable size through each available
-SKComm transport. Reports p50/p95/p99 latency, throughput (msg/s),
+SKComms transport. Reports p50/p95/p99 latency, throughput (msg/s),
 and error rate.
 
 The file transport is benchmarked via a local temp-dir loopback
@@ -25,14 +25,14 @@ from rich.table import Table
 
 from ._common import console
 
-# Mirrors skcomm.core.BUILTIN_TRANSPORTS — kept local to avoid hard dep
+# Mirrors skcomms.core.BUILTIN_TRANSPORTS — kept local to avoid hard dep
 _BUILTIN_TRANSPORTS: dict[str, str] = {
-    "file": "skcomm.transports.file",
-    "syncthing": "skcomm.transports.syncthing",
-    "nostr": "skcomm.transports.nostr",
-    "websocket": "skcomm.transports.websocket",
-    "tailscale": "skcomm.transports.tailscale",
-    "webrtc": "skcomm.transports.webrtc",
+    "file": "skcomms.transports.file",
+    "syncthing": "skcomms.transports.syncthing",
+    "nostr": "skcomms.transports.nostr",
+    "websocket": "skcomms.transports.websocket",
+    "tailscale": "skcomms.transports.tailscale",
+    "webrtc": "skcomms.transports.webrtc",
 }
 
 
@@ -70,9 +70,9 @@ def _bench_file_loopback(count: int, size: int) -> dict:
         Result dict with status, mode, latency percentiles, throughput,
         and error counts.
     """
-    tmp = tempfile.mkdtemp(prefix="skcomm_bench_")
+    tmp = tempfile.mkdtemp(prefix="skcomms_bench_")
     try:
-        mod = importlib.import_module("skcomm.transports.file")
+        mod = importlib.import_module("skcomms.transports.file")
         factory = getattr(mod, "create_transport", None)
         if factory is None:
             return {"status": "error", "error": "no create_transport() in file transport"}
@@ -108,7 +108,7 @@ def _bench_file_loopback(count: int, size: int) -> dict:
         }
 
     except ImportError:
-        return {"status": "unavailable", "error": "skcomm not installed"}
+        return {"status": "unavailable", "error": "skcomms not installed"}
     except Exception as exc:
         return {"status": "error", "error": str(exc)[:120]}
     finally:
@@ -247,7 +247,7 @@ def run_bench(
 def _render_table(results: list[dict], count: int, size: int, health_count: int) -> None:
     """Render benchmark results as a Rich table with a fastest-transport summary."""
     table = Table(
-        title=f"SKComm Transport Benchmark  [{count} msgs × {size}B | health×{health_count}]",
+        title=f"SKComms Transport Benchmark  [{count} msgs × {size}B | health×{health_count}]",
         show_header=True,
         header_style="bold magenta",
     )
@@ -333,7 +333,7 @@ def register_bench_commands(main: click.Group) -> None:
         transports: tuple,
         json_out: bool,
     ) -> None:
-        """Benchmark SKComm transport throughput and latency.
+        """Benchmark SKComms transport throughput and latency.
 
         Sends COUNT messages of SIZE bytes through each available transport
         and reports p50/p95/p99 latency, throughput (msg/s), and error rate.
@@ -357,7 +357,7 @@ def register_bench_commands(main: click.Group) -> None:
         if not json_out:
             scope = ", ".join(selected) if selected else "all transports"
             console.print(
-                f"[bold]SKComm Transport Benchmark[/]  "
+                f"[bold]SKComms Transport Benchmark[/]  "
                 f"scope={scope}  count={count}  size={size}B  "
                 f"health-count={health_count}"
             )

package/src/skcapstone/cli/chat.py

@@ -13,12 +13,15 @@ skcapstone chat summary <peer>      LLM-powered conversation summary
 from __future__ import annotations
 
 import json
+import logging
 import sys
 from pathlib import Path
 from typing import Optional
 
 import click
 
+logger = logging.getLogger(__name__)
+
 from ._common import AGENT_HOME, console, get_runtime
 from ._validators import validate_agent_name
 
@@ -85,8 +88,8 @@ def _run_llm_chat(peer: str, home_path: Path, identity: str) -> None:
                     content = msg.get("content", "")[:100]
                     console.print(f"  {label}: {content}")
                 console.print()
-        except Exception:
-            pass
+        except Exception as exc:
+            logger.warning("Failed to load previous conversation history with %s: %s", peer, exc)
 
     console.print(f"[bold]Chat with [cyan]{peer}[/][/]  [dim]Ctrl+C or /quit to exit[/]\n")
 
@@ -194,7 +197,7 @@ def register_chat_commands(main: click.Group) -> None:
     def chat_send(peer: str, message: str, home: str, thread: Optional[str], encrypt: bool):
         """Send a message to a peer agent.
 
-        Stores locally and delivers via SKComm if transports
+        Stores locally and delivers via SKComms if transports
         are configured.
 
         \b
@@ -248,7 +251,7 @@ def register_chat_commands(main: click.Group) -> None:
         """Show recent messages.
 
         Displays messages from local history. Use --poll to check
-        SKComm transports for new messages first. Use --decrypt to
+        SKComms transports for new messages first. Use --decrypt to
         automatically decrypt AES-256-GCM encrypted messages.
 
         \b

package/src/skcapstone/cli/consciousness.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import json
+import logging
 import sys
 from pathlib import Path
 
@@ -10,6 +11,8 @@ import click
 
 from ._common import AGENT_HOME, console
 
+logger = logging.getLogger(__name__)
+
 
 def register_consciousness_commands(main: click.Group) -> None:
     """Register the consciousness command group."""
@@ -233,8 +236,8 @@ def register_consciousness_commands(main: click.Group) -> None:
                 try:
                     file_data = json.loads(daily.read_text(encoding="utf-8"))
                     quality = file_data.get("quality_avg", {})
-                except Exception:
-                    pass
+                except Exception as exc:
+                    logger.warning("Failed to read daily quality metrics from %s: %s", daily, exc)
 
         if not quality or quality.get("count", 0) == 0:
             if json_out:

package/src/skcapstone/cli/context_cmd.py

@@ -6,7 +6,8 @@ from pathlib import Path
 
 import click
 
-from ._common import AGENT_HOME, console
+from ._common import AGENT_HOME, SKCAPSTONE_AGENT, console, resolve_agent_home
+from ._validators import validate_file_path
 
 
 def register_context_commands(main: click.Group) -> None:
@@ -22,7 +23,11 @@ def register_context_commands(main: click.Group) -> None:
         """
 
     @context.command("show")
-    @click.option("--home", default=AGENT_HOME, type=click.Path())
+    @click.option(
+        "--home",
+        default=str(resolve_agent_home(SKCAPSTONE_AGENT)),
+        type=click.Path(),
+    )
     @click.option(
         "--format",
         "fmt",
@@ -55,7 +60,11 @@ def register_context_commands(main: click.Group) -> None:
             click.echo(FORMATTERS[fmt](ctx))
 
     @context.command("generate")
-    @click.option("--home", default=AGENT_HOME, type=click.Path())
+    @click.option(
+        "--home",
+        default=str(resolve_agent_home(SKCAPSTONE_AGENT)),
+        type=click.Path(),
+    )
     @click.option("--memories", "-n", default=10, help="Max recent memories to include.")
     @click.option(
         "--target",
@@ -95,7 +104,11 @@ def register_context_commands(main: click.Group) -> None:
         console.print()
 
     @main.command("refresh-context")
-    @click.option("--home", default=AGENT_HOME, type=click.Path())
+    @click.option(
+        "--home",
+        default=str(resolve_agent_home(SKCAPSTONE_AGENT)),
+        type=click.Path(),
+    )
     @click.option("--memories", "-n", default=10, help="Max recent memories to embed.")
     @click.option(
         "--dest",
@@ -122,6 +135,7 @@ def register_context_commands(main: click.Group) -> None:
         home_path = Path(home).expanduser()
 
         if dest:
+            validate_file_path(dest)
             target = Path(dest).expanduser().resolve()
             if target.is_dir():
                 target = target / "CLAUDE.md"

package/src/skcapstone/cli/daemon.py

@@ -140,7 +140,8 @@ def register_daemon_commands(main: click.Group) -> None:
         effective_port = _resolve_agent_port(agent, port)
 
         if agent:
-            # Propagate identity to child imports that read SKCAPSTONE_AGENT.
+            # Propagate identity to child imports that read SKAGENT.
+            os.environ["SKAGENT"] = agent
             os.environ["SKCAPSTONE_AGENT"] = agent
 
         if not home_path.exists():
@@ -314,22 +315,25 @@ def register_daemon_commands(main: click.Group) -> None:
             console.print()
 
         elif platform.system() == "Linux":
-            from ..systemd import install_service, systemd_available
+            from ..systemd import install_service, systemd_available, SERVICE_NAME
 
             if not systemd_available():
                 console.print("[red]systemd user session not available.[/]")
                 console.print("[dim]This command requires a Linux system with systemd.[/]")
                 raise SystemExit(1)
 
-            console.print("\n[cyan]Installing skcapstone systemd service...[/]")
-            result = install_service(start=start)
+            console.print(f"\n[cyan]Installing skcapstone systemd service for agent '{effective_agent}'...[/]")
+            result = install_service(agent_name=effective_agent, start=start)
+            svc_name = result.get("service_name", SERVICE_NAME)
 
             if result["installed"]:
-                console.print("[green]  Unit files installed.[/]")
+                console.print(f"[green]  Unit files installed ({svc_name}).[/]")
             if result["enabled"]:
-                console.print("[green]  Service enabled at login.[/]")
+                console.print(f"[green]  Service enabled at login.[/]")
             if result.get("started"):
-                console.print("[green]  Service started.[/]")
+                console.print(f"[green]  Service started.[/]")
+            else:
+                console.print(f"[dim]  Start: systemctl --user start {svc_name}[/]")
             console.print()
 
             if not result["installed"]:

package/src/skcapstone/cli/gtd.py

@@ -108,10 +108,35 @@ def register_gtd_commands(main: click.Group) -> None:
         console.print()
 
     @gtd.command("status")
-    def gtd_status():
+    @click.option("--brief", is_flag=True,
+                  help="One-line summary (for hooks / session start).")
+    def gtd_status(brief: bool):
         """Summary of all GTD lists."""
         from ..mcp_tools.gtd_tools import _load_list, _GTD_LISTS
 
+        if brief:
+            from datetime import datetime, timezone
+
+            counts = {name: len(_load_list(name)) for name in _GTD_LISTS}
+            now = datetime.now(timezone.utc)
+            stale = 0
+            for p in _load_list("projects"):
+                ts = p.get("moved_at") or p.get("created_at")
+                try:
+                    if ts and (now - datetime.fromisoformat(ts)).days >= 7:
+                        stale += 1
+                except (ValueError, TypeError):
+                    pass
+            stale_str = f" ({stale} stale)" if stale else ""
+            click.echo(
+                f"GTD: {counts.get('inbox', 0)} inbox · "
+                f"{counts.get('next-actions', 0)} next · "
+                f"{counts.get('projects', 0)} projects{stale_str} · "
+                f"{counts.get('waiting-for', 0)} waiting · "
+                f"{counts.get('someday-maybe', 0)} someday"
+            )
+            return
+
         console.print()
         total = 0
         rows = []

package/src/skcapstone/cli/housekeeping.py

@@ -14,9 +14,9 @@ def register_housekeeping_commands(main: click.Group) -> None:
 
     @main.command("housekeeping")
     @click.option("--home", default=AGENT_HOME, type=click.Path(), help="Agent home directory.")
-    @click.option("--skcomm-home", default="~/.skcomm", type=click.Path(), help="SKComm home directory.")
+    @click.option("--skcomms-home", default="~/.skcomms", type=click.Path(), help="SKComms home directory.")
     @click.option("--dry-run", is_flag=True, help="Report what would be deleted without deleting.")
-    def housekeeping(home: str, skcomm_home: str, dry_run: bool):
+    def housekeeping(home: str, skcomms_home: str, dry_run: bool):
         """Prune stale ACKs, delivered envelopes, and old seeds.
 
         Reclaims disk space from files that accumulate in the agent
@@ -33,7 +33,7 @@ def register_housekeeping_commands(main: click.Group) -> None:
 
         results = run_housekeeping(
             skcapstone_home=Path(home).expanduser(),
-            skcomm_home=Path(skcomm_home).expanduser(),
+            skcomms_home=Path(skcomms_home).expanduser(),
             dry_run=dry_run,
         )