@smilintux/skcapstone 0.1.0 → 0.2.4

package/src/skcapstone/cli/peer.py

@@ -0,0 +1,154 @@
+"""Peer management commands: add, list, remove, show."""
+
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+import click
+
+from ._common import AGENT_HOME, console
+from ._validators import validate_agent_name
+
+from rich.panel import Panel
+from rich.table import Table
+
+
+def register_peer_commands(main: click.Group) -> None:
+    """Register the peer command group."""
+
+    @main.group()
+    def peer():
+        """Peer management — discover, add, and manage trusted contacts."""
+
+    @peer.command("add")
+    @click.option("--card", "card_path", type=click.Path(exists=True), help="Import from identity card.")
+    @click.option("--name", default=None, help="Peer name (required if not using --card).")
+    @click.option("--pubkey", default=None, type=click.Path(exists=True), help="Path to PGP public key.")
+    @click.option("--email", default=None, help="Peer contact email.")
+    @click.option("--home", "sk_home", default=AGENT_HOME, type=click.Path())
+    def peer_add(card_path, name, pubkey, email, sk_home):
+        """Add a peer from an identity card or manually."""
+        from ..peers import add_peer_from_card, add_peer_manual
+
+        sk_path = Path(sk_home).expanduser()
+
+        if card_path:
+            try:
+                peer_record = add_peer_from_card(Path(card_path), skcapstone_home=sk_path)
+                fp = peer_record.fingerprint[:16] + "..." if peer_record.fingerprint else "none"
+                console.print(f"\n  [green]Added peer:[/] [cyan]{peer_record.name}[/]")
+                console.print(f"  Fingerprint: [dim]{fp}[/]")
+                console.print(f"  Type: {peer_record.entity_type}")
+                console.print(f"  Trust: {peer_record.trust_level}")
+                console.print(f"  Capabilities: {', '.join(peer_record.capabilities[:5])}")
+                if peer_record.public_key:
+                    console.print(f"  [green]Public key imported[/] — encrypted messaging enabled")
+                console.print()
+            except (FileNotFoundError, ValueError) as exc:
+                console.print(f"\n  [red]Error:[/] {exc}\n")
+                sys.exit(1)
+        elif name:
+            peer_record = add_peer_manual(
+                name=name, public_key_path=Path(pubkey) if pubkey else None,
+                email=email or "", skcapstone_home=sk_path,
+            )
+            console.print(f"\n  [green]Added peer:[/] [cyan]{peer_record.name}[/]")
+            if peer_record.public_key:
+                console.print(f"  [green]Public key imported[/]")
+            console.print()
+        else:
+            console.print("\n  [yellow]Provide --card or --name.[/]")
+            console.print("  skcapstone peer add --card card.json")
+            console.print("  skcapstone peer add --name Lumina --pubkey lumina.pub.asc\n")
+            sys.exit(1)
+
+    @peer.command("list")
+    @click.option("--home", "sk_home", default=AGENT_HOME, type=click.Path())
+    @click.option("--json-out", is_flag=True, help="Output as JSON.")
+    def peer_list(sk_home, json_out):
+        """List all known peers."""
+        from ..peers import list_peers
+
+        peers = list_peers(skcapstone_home=Path(sk_home).expanduser())
+
+        if json_out:
+            click.echo(json.dumps([p.model_dump() for p in peers], indent=2, default=str))
+            return
+
+        console.print()
+        if not peers:
+            console.print("  [dim]No peers registered.[/]")
+            console.print("  Add one: skcapstone peer add --card card.json")
+            console.print()
+            return
+
+        table = Table(show_header=True, header_style="bold", box=None, padding=(0, 2),
+                      title=f"Known Peers ({len(peers)})")
+        table.add_column("Name", style="cyan")
+        table.add_column("Type", style="dim")
+        table.add_column("Fingerprint", style="dim", max_width=20)
+        table.add_column("Trust")
+        table.add_column("Key")
+
+        for p in peers:
+            fp = p.fingerprint[:16] + "..." if p.fingerprint else ""
+            has_key = "[green]yes[/]" if p.public_key else "[yellow]no[/]"
+            table.add_row(p.name, p.entity_type, fp, p.trust_level, has_key)
+
+        console.print(table)
+        console.print()
+
+    @peer.command("remove")
+    @click.argument("name")
+    @click.option("--home", "sk_home", default=AGENT_HOME, type=click.Path())
+    def peer_remove(name, sk_home):
+        """Remove a peer by name."""
+        from ..peers import remove_peer
+
+        validate_agent_name(name)
+
+        removed = remove_peer(name, skcapstone_home=Path(sk_home).expanduser())
+        if removed:
+            console.print(f"\n  [green]Removed peer:[/] {name}\n")
+        else:
+            console.print(f"\n  [yellow]Peer '{name}' not found.[/]\n")
+
+    @peer.command("show")
+    @click.argument("name")
+    @click.option("--home", "sk_home", default=AGENT_HOME, type=click.Path())
+    def peer_show(name, sk_home):
+        """Show detailed info about a peer."""
+        from ..peers import get_peer
+
+        validate_agent_name(name)
+
+        p = get_peer(name, skcapstone_home=Path(sk_home).expanduser())
+        if not p:
+            console.print(f"\n  [yellow]Peer '{name}' not found.[/]\n")
+            return
+
+        fp = p.fingerprint[:20] + "..." if len(p.fingerprint) > 20 else p.fingerprint
+        lines = [
+            f"[bold]Name:[/]         [cyan]{p.name}[/]",
+            f"[bold]Type:[/]         {p.entity_type}",
+            f"[bold]Fingerprint:[/]  [dim]{fp}[/]",
+            f"[bold]Trust:[/]        {p.trust_level}",
+            f"[bold]Source:[/]       {p.source}",
+            f"[bold]Added:[/]        {p.added_at[:19]}",
+        ]
+        if p.handle:
+            lines.append(f"[bold]Handle:[/]       {p.handle}")
+        if p.email:
+            lines.append(f"[bold]Email:[/]        {p.email}")
+        if p.capabilities:
+            lines.append(f"[bold]Capabilities:[/] {', '.join(p.capabilities[:6])}")
+        if p.contact_uris:
+            for uri in p.contact_uris:
+                lines.append(f"[bold]Contact:[/]      [cyan]{uri}[/]")
+        lines.append(f"[bold]PGP Key:[/]      {'[green]present[/]' if p.public_key else '[yellow]missing[/]'}")
+
+        console.print()
+        console.print(Panel("\n".join(lines), title=f"Peer: {p.name}", border_style="cyan"))
+        console.print()

package/src/skcapstone/cli/peers_dir.py

@@ -0,0 +1,122 @@
+"""Peer directory commands: peers list, peers add, peers remove, peers discover."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import click
+
+from ._common import AGENT_HOME, console
+
+from rich.table import Table
+
+
+def register_peers_dir_commands(main: click.Group) -> None:
+    """Register the peers (directory) command group."""
+
+    @main.group("peers")
+    def peers_dir():
+        """Peer transport directory — routing addresses for the mesh."""
+
+    @peers_dir.command("list")
+    @click.option("--home", "sk_home", default=AGENT_HOME, type=click.Path())
+    @click.option("--json-out", is_flag=True, help="Output as JSON.")
+    def peers_list(sk_home, json_out):
+        """List all peers in the transport directory."""
+        from ..peer_directory import PeerDirectory
+
+        directory = PeerDirectory(home=Path(sk_home).expanduser())
+        peers = directory.list_peers()
+
+        if json_out:
+            click.echo(json.dumps([p.model_dump() for p in peers], indent=2, default=str))
+            return
+
+        console.print()
+        if not peers:
+            console.print("  [dim]No peers in directory.[/]")
+            console.print("  Add one: skcapstone peers add --name lumina --address /path/to/outbox/lumina")
+            console.print("  Or auto-discover: skcapstone peers discover")
+            console.print()
+            return
+
+        table = Table(
+            show_header=True,
+            header_style="bold",
+            box=None,
+            padding=(0, 2),
+            title=f"Peer Transport Directory ({len(peers)})",
+        )
+        table.add_column("Name", style="cyan")
+        table.add_column("Transport", style="dim")
+        table.add_column("Address")
+        table.add_column("Last Seen", style="dim")
+
+        for p in peers:
+            last = p.last_seen[:19] if p.last_seen else "[dim]never[/]"
+            table.add_row(p.name, p.transport, p.address, last)
+
+        console.print(table)
+        console.print()
+
+    @peers_dir.command("add")
+    @click.option("--name", required=True, help="Peer name.")
+    @click.option("--address", required=True, help="Transport address (path, IP, URI).")
+    @click.option(
+        "--transport",
+        default="syncthing",
+        show_default=True,
+        help="Transport type: syncthing, webrtc, tailscale, file.",
+    )
+    @click.option("--fingerprint", default="", help="PGP fingerprint (optional).")
+    @click.option("--home", "sk_home", default=AGENT_HOME, type=click.Path())
+    def peers_add(name, address, transport, fingerprint, sk_home):
+        """Add a peer to the transport directory."""
+        from ..peer_directory import PeerDirectory
+
+        directory = PeerDirectory(home=Path(sk_home).expanduser())
+        entry = directory.add_peer(
+            name=name,
+            address=address,
+            transport=transport,
+            fingerprint=fingerprint,
+        )
+        console.print(f"\n  [green]Added peer:[/] [cyan]{entry.name}[/]")
+        console.print(f"  Transport: {entry.transport}")
+        console.print(f"  Address:   {entry.address}")
+        if entry.fingerprint:
+            console.print(f"  Fingerprint: [dim]{entry.fingerprint[:20]}...[/]")
+        console.print()
+
+    @peers_dir.command("remove")
+    @click.argument("name")
+    @click.option("--home", "sk_home", default=AGENT_HOME, type=click.Path())
+    def peers_remove(name, sk_home):
+        """Remove a peer from the transport directory."""
+        from ..peer_directory import PeerDirectory
+
+        directory = PeerDirectory(home=Path(sk_home).expanduser())
+        removed = directory.remove_peer(name)
+        if removed:
+            console.print(f"\n  [green]Removed:[/] {name}\n")
+        else:
+            console.print(f"\n  [yellow]Peer '{name}' not in directory.[/]\n")
+
+    @peers_dir.command("discover")
+    @click.option("--home", "sk_home", default=AGENT_HOME, type=click.Path())
+    def peers_discover(sk_home):
+        """Auto-discover peers from heartbeat files and Syncthing outbox."""
+        from ..peer_directory import PeerDirectory
+
+        directory = PeerDirectory(home=Path(sk_home).expanduser())
+        added = directory.auto_discover()
+
+        console.print()
+        if not added:
+            console.print("  [dim]No new peers discovered.[/]")
+        else:
+            console.print(f"  [green]Discovered {len(added)} new peer(s):[/]")
+            for entry in added:
+                console.print(f"    [cyan]{entry.name}[/] — {entry.transport} → {entry.address}")
+        console.print()

package/src/skcapstone/cli/preflight_cmd.py

@@ -0,0 +1,83 @@
+"""CLI command: skcapstone preflight — run daemon startup checks."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import click
+
+from ._common import AGENT_HOME, console
+
+
+def register_preflight_commands(main: click.Group) -> None:
+    """Register the preflight command."""
+
+    @main.command("preflight")
+    @click.option("--home", default=AGENT_HOME, type=click.Path(),
+                  help="Agent home directory.")
+    @click.option("--json-out", is_flag=True, help="Output as JSON.")
+    def preflight_cmd(home: str, json_out: bool):
+        """Run daemon preflight checks.
+
+        Verifies that the environment is ready for daemon startup:
+        Python version, required packages, Ollama, PGP identity,
+        home directory structure, consciousness config, and disk space.
+
+        Exits with code 0 if all critical checks pass, 1 otherwise.
+
+        Examples:
+
+            skcapstone preflight
+
+            skcapstone preflight --json-out
+        """
+        import json
+        from ..preflight import PreflightChecker
+
+        checker = PreflightChecker(home=Path(home).expanduser())
+        summary = checker.run_all()
+
+        if json_out:
+            click.echo(json.dumps(summary, indent=2))
+            sys.exit(0 if summary["ok"] else 1)
+
+        # Colored table output
+        console.print()
+        console.print("[bold]Daemon Preflight Checks[/]")
+        console.print()
+
+        status_styles = {
+            "ok": ("[green]  OK  [/]", "green"),
+            "warn": ("[yellow] WARN [/]", "yellow"),
+            "fail": ("[bold red] FAIL [/]", "red"),
+        }
+
+        for check in summary["checks"]:
+            badge, color = status_styles.get(check["status"], ("[dim]  ?  [/]", "white"))
+            name = check["name"].ljust(12)
+            msg = check["message"]
+            console.print(f"  {badge}  [{color}]{name}[/]  {msg}")
+
+        console.print()
+
+        warnings = summary["warnings"]
+        failures = summary["failures"]
+        critical = summary["critical_failures"]
+
+        if summary["ok"]:
+            if warnings or failures:
+                console.print(
+                    f"[yellow]Preflight passed with {warnings} warning(s) "
+                    f"and {failures} non-critical failure(s).[/]"
+                )
+            else:
+                console.print("[bold green]All preflight checks passed.[/]")
+        else:
+            console.print(
+                f"[bold red]Preflight FAILED — {critical} critical failure(s).[/] "
+                "Fix the issues above before starting the daemon."
+            )
+
+        console.print()
+        sys.exit(0 if summary["ok"] else 1)

package/src/skcapstone/cli/profile_cmd.py

@@ -0,0 +1,310 @@
+"""Profile commands: list, show, stale."""
+
+from __future__ import annotations
+
+import json
+import sys
+from datetime import date, datetime, timedelta, timezone
+from pathlib import Path
+
+import click
+
+from ._common import AGENT_HOME, console
+
+
+# Number of days before a profile is considered stale.
+_STALE_DAYS = 90
+
+
+def _load_profiles_path(home: str) -> Path | None:
+    """Resolve the agent-level model_profiles.yaml override if it exists.
+
+    Args:
+        home: Agent home directory path.
+
+    Returns:
+        Path to agent-level profiles YAML, or None to use bundled defaults.
+    """
+    agent_override = Path(home).expanduser() / "config" / "model_profiles.yaml"
+    if agent_override.exists():
+        return agent_override
+    return None
+
+
+def _get_adapter(home: str):
+    """Return a PromptAdapter, preferring agent-level profiles.
+
+    Args:
+        home: Agent home directory.
+
+    Returns:
+        PromptAdapter instance with profiles loaded.
+    """
+    from ..prompt_adapter import PromptAdapter
+
+    profiles_path = _load_profiles_path(home)
+    return PromptAdapter(profiles_path)
+
+
+def _parse_last_updated(value: str) -> date | None:
+    """Parse a last_updated string to a date object.
+
+    Args:
+        value: ISO-8601 date string (e.g. "2026-03-02").
+
+    Returns:
+        date object or None if the string is empty / unparseable.
+    """
+    if not value:
+        return None
+    try:
+        return datetime.strptime(value, "%Y-%m-%d").date()
+    except ValueError:
+        return None
+
+
+def register_profile_commands(main: click.Group) -> None:
+    """Register the ``profile`` command group on the main CLI."""
+
+    @main.group()
+    def profile():
+        """Model profile management — inspect prompt-formatting profiles.
+
+        Model profiles define how prompts are formatted for each LLM family:
+        system-prompt placement, structure format, thinking mode, temperature
+        defaults, and more.
+
+        The bundled profiles live in ``data/model_profiles.yaml``.  To
+        override any entry, place a custom copy at::
+
+            ~/.skcapstone/agents/<name>/config/model_profiles.yaml
+        """
+
+    # ------------------------------------------------------------------
+    # profile list
+    # ------------------------------------------------------------------
+
+    @profile.command("list")
+    @click.option(
+        "--home", default=AGENT_HOME, type=click.Path(),
+        help="Agent home directory (used to resolve overrides).",
+    )
+    @click.option("--json", "json_out", is_flag=True, help="Output raw JSON.")
+    def profile_list(home: str, json_out: bool) -> None:
+        """List all loaded model profiles.
+
+        Profiles are shown in the order they are matched (first match wins).
+        The agent-level override (if present) is merged on top of the
+        bundled defaults.
+
+        Examples:
+
+            skcapstone profile list
+
+            skcapstone profile list --json
+        """
+        from rich.panel import Panel
+        from rich.table import Table
+
+        adapter = _get_adapter(home)
+        profiles = adapter.profiles
+
+        if not profiles:
+            console.print("\n  [dim]No profiles loaded.[/]\n")
+            sys.exit(1)
+
+        if json_out:
+            rows = [p.model_dump() for p in profiles]
+            click.echo(json.dumps(rows, indent=2))
+            return
+
+        table = Table(show_header=True, header_style="bold", box=None, padding=(0, 2))
+        table.add_column("Family", style="cyan")
+        table.add_column("Pattern", style="dim")
+        table.add_column("Sys-prompt mode")
+        table.add_column("Format")
+        table.add_column("Thinking")
+        table.add_column("Updated", style="dim")
+
+        for p in profiles:
+            thinking = p.thinking_mode if p.thinking_enabled else "off"
+            table.add_row(
+                p.family,
+                p.model_pattern,
+                p.system_prompt_mode,
+                p.structure_format,
+                thinking,
+                p.last_updated or "[dim]unknown[/]",
+            )
+
+        label = f"[bold]{len(profiles)}[/] model profile(s) loaded"
+        console.print()
+        console.print(
+            Panel(label, title="Model Profiles", border_style="bright_blue")
+        )
+        console.print(table)
+        console.print()
+
+    # ------------------------------------------------------------------
+    # profile show
+    # ------------------------------------------------------------------
+
+    @profile.command("show")
+    @click.argument("model")
+    @click.option(
+        "--home", default=AGENT_HOME, type=click.Path(),
+        help="Agent home directory (used to resolve overrides).",
+    )
+    @click.option("--json", "json_out", is_flag=True, help="Output raw JSON.")
+    def profile_show(model: str, home: str, json_out: bool) -> None:
+        """Show the profile matched for MODEL.
+
+        MODEL is matched against all profile ``model_pattern`` regexes.
+        If nothing matches, the generic fallback profile is shown.
+
+        Examples:
+
+            skcapstone profile show claude-opus-4-5
+
+            skcapstone profile show grok-3
+
+            skcapstone profile show deepseek-r1-70b --json
+        """
+        from rich.panel import Panel
+        from rich.table import Table
+
+        adapter = _get_adapter(home)
+        p = adapter.resolve_profile(model)
+
+        if json_out:
+            click.echo(json.dumps(p.model_dump(), indent=2))
+            return
+
+        console.print()
+        console.print(
+            Panel(
+                f"Profile for [bold cyan]{model}[/] → family [bold]{p.family}[/]",
+                border_style="cyan",
+                padding=(0, 2),
+            )
+        )
+
+        table = Table(show_header=False, box=None, padding=(0, 2))
+        table.add_column("Field", style="bold dim", min_width=28)
+        table.add_column("Value")
+
+        rows = [
+            ("model_pattern", p.model_pattern),
+            ("family", p.family),
+            ("system_prompt_mode", p.system_prompt_mode),
+            ("structure_format", p.structure_format),
+            ("thinking_enabled", str(p.thinking_enabled)),
+            ("thinking_mode", p.thinking_mode),
+            ("thinking_budget_tokens", str(p.thinking_budget_tokens)),
+            ("default_temperature",
+             str(p.default_temperature) if p.default_temperature is not None else "[dim]—[/]"),
+            ("code_temperature",
+             str(p.code_temperature) if p.code_temperature is not None else "[dim]—[/]"),
+            ("reasoning_temperature",
+             str(p.reasoning_temperature) if p.reasoning_temperature is not None else "[dim]—[/]"),
+            ("max_system_tokens", str(p.max_system_tokens)),
+            ("tool_format", p.tool_format),
+            ("no_few_shot", str(p.no_few_shot)),
+            ("no_cot_instructions", str(p.no_cot_instructions)),
+            ("last_updated", p.last_updated or "[dim]unknown[/]"),
+            ("source_url", p.source_url or "[dim]—[/]"),
+            ("notes", p.notes or "[dim]—[/]"),
+        ]
+
+        for field, value in rows:
+            table.add_row(field, value)
+
+        console.print(table)
+        console.print()
+
+    # ------------------------------------------------------------------
+    # profile stale
+    # ------------------------------------------------------------------
+
+    @profile.command("stale")
+    @click.option(
+        "--home", default=AGENT_HOME, type=click.Path(),
+        help="Agent home directory (used to resolve overrides).",
+    )
+    @click.option(
+        "--days", default=_STALE_DAYS, type=int, show_default=True,
+        help="Number of days before a profile is considered stale.",
+    )
+    @click.option("--json", "json_out", is_flag=True, help="Output raw JSON.")
+    def profile_stale(home: str, days: int, json_out: bool) -> None:
+        """Show profiles older than DAYS days (default: 90).
+
+        A profile is stale when its ``last_updated`` date is more than
+        ``--days`` days in the past, or when ``last_updated`` is missing.
+
+        Stale profiles may have outdated guidance — consider refreshing
+        them against the latest provider documentation.
+
+        Examples:
+
+            skcapstone profile stale
+
+            skcapstone profile stale --days 30
+
+            skcapstone profile stale --json
+        """
+        from rich.panel import Panel
+        from rich.table import Table
+
+        adapter = _get_adapter(home)
+        cutoff = date.today() - timedelta(days=days)
+
+        stale = []
+        for p in adapter.profiles:
+            updated = _parse_last_updated(p.last_updated)
+            if updated is None or updated < cutoff:
+                stale.append((p, updated))
+
+        if json_out:
+            rows = []
+            for p, updated in stale:
+                d = p.model_dump()
+                d["_days_old"] = (
+                    (date.today() - updated).days if updated else None
+                )
+                rows.append(d)
+            click.echo(json.dumps(rows, indent=2))
+            return
+
+        if not stale:
+            console.print(
+                f"\n  [bold green]✓[/] All profiles updated within {days} days.\n"
+            )
+            return
+
+        label = (
+            f"[bold]{len(stale)}[/] stale profile(s) "
+            f"(older than {days} days — cutoff [dim]{cutoff}[/])"
+        )
+        console.print()
+        console.print(
+            Panel(label, title="Stale Profiles", border_style="yellow")
+        )
+
+        table = Table(show_header=True, header_style="bold", box=None, padding=(0, 2))
+        table.add_column("Family", style="cyan")
+        table.add_column("Pattern", style="dim")
+        table.add_column("Last Updated", style="yellow")
+        table.add_column("Age (days)", style="red")
+
+        for p, updated in stale:
+            age = str((date.today() - updated).days) if updated else "[dim]unknown[/]"
+            table.add_row(
+                p.family,
+                p.model_pattern,
+                p.last_updated or "[dim]missing[/]",
+                age,
+            )
+
+        console.print(table)
+        console.print()