@smilintux/skcapstone 0.4.2 → 0.4.3

package/README.md

@@ -165,6 +165,66 @@ skcapstone status
 
 ---
 
+## Windows Quickstart
+
+SKCapstone runs natively on Windows. The installer creates a virtualenv at `%LOCALAPPDATA%\skenv` and adds its `Scripts` directory to your user PATH.
+
+### Prerequisites
+
+- **Python 3.10+** — [python.org/downloads](https://www.python.org/downloads/) (check "Add to PATH" during install)
+- **Git for Windows** — [git-scm.com](https://git-scm.com/download/win)
+- **Syncthing** (optional) — for cross-device sync ([syncthing.net](https://syncthing.net/downloads/))
+
+### Install
+
+```powershell
+# Clone and install (creates %LOCALAPPDATA%\skenv venv)
+git clone https://github.com/smilintux-org/skcapstone.git
+cd skcapstone
+.\scripts\install.ps1
+
+# The installer adds %LOCALAPPDATA%\skenv\Scripts to your user PATH.
+# Restart your terminal for PATH changes to take effect.
+
+# Initialize your agent
+skcapstone init --name "YourAgent"
+
+# Check status
+skcapstone status
+```
+
+### Syncthing Sync (Optional)
+
+To sync your agent across devices (e.g., Windows desktop + Linux server):
+
+1. Install [Syncthing](https://syncthing.net/downloads/) on both machines
+2. Share the `%USERPROFILE%\.skcapstone` folder between devices
+3. Agent state (memories, identity, trust, seeds) syncs automatically
+
+### OpenClaw Integration
+
+If you're running [OpenClaw](https://github.com/smilintux-org/openclaw), the SK* plugins register automatically during install:
+
+```powershell
+# Re-register if needed
+skcapstone register
+
+# Verify plugins are loaded in OpenClaw
+# Plugins provide tools for status, rehydration, coordination,
+# soul management, and agent profiles directly in OpenClaw agents.
+```
+
+### Task Scheduler (Background Service)
+
+On Windows, the daemon runs via Task Scheduler instead of systemd:
+
+```powershell
+# Install the scheduled task (runs at logon)
+.\scripts\windows\install-tasks.ps1
+```
+
+---
+
 ## DID Tools
 
 SKCapstone exposes a set of **Decentralized Identifier (DID)** MCP tools for sovereign identity management. These tools are available to Claude Code and other MCP clients through the `mcp_tools/did_tools.py` module.
@@ -223,6 +283,7 @@ DIDs are organized in three tiers of trust and discoverability:
 | **SKComm** | Communication — Encrypted channels between agents |
 | **SKChat** | Chat — AI-native encrypted messaging |
 | **SKForge** | Generation — Blueprint creation with agent context |
+| **SKSeed** | Epistemic rigor — Steel man collider, truth alignment, memory audit |
 | **SKStacks** | Infrastructure — Self-hosted deployment patterns |
 
 ---

package/openclaw-plugin/src/index.ts

@@ -16,16 +16,28 @@ const SKCAPSTONE_BIN = process.env.SKCAPSTONE_BIN || "skcapstone";
 const SKMEMORY_BIN = process.env.SKMEMORY_BIN || "skmemory";
 const SKCAPSTONE_AGENT = process.env.SKCAPSTONE_AGENT || "lumina";
 const EXEC_TIMEOUT = 60_000;
+const IS_WIN = process.platform === "win32";
 
-function runCli(bin: string, args: string): { ok: boolean; output: string } {
+function skenvPath(): string {
+  if (IS_WIN) {
+    const local = process.env.LOCALAPPDATA || "";
+    return `${local}\\skenv\\Scripts`;
+  }
+  const home = process.env.HOME || "";
+  return `${home}/.local/bin:${home}/.skenv/bin`;
+}
+
+function runCli(bin: string, args: string, agentOverride?: string): { ok: boolean; output: string } {
+  const sep = IS_WIN ? ";" : ":";
+  const agent = agentOverride || SKCAPSTONE_AGENT;
   try {
     const raw = execSync(`${bin} ${args}`, {
       encoding: "utf-8",
       timeout: EXEC_TIMEOUT,
       env: {
         ...process.env,
-        SKCAPSTONE_AGENT,
-        PATH: `${process.env.HOME}/.local/bin:${process.env.HOME}/.skenv/bin:${process.env.PATH}`,
+        SKCAPSTONE_AGENT: agent,
+        PATH: `${skenvPath()}${sep}${process.env.PATH}`,
       },
     }).trim();
     return { ok: true, output: raw };
@@ -299,6 +311,62 @@ function createSKCapstoneSoulShowTool() {
   };
 }
 
+function createSKCapstoneAgentListTool() {
+  return {
+    name: "skcapstone_agent_list",
+    label: "SKCapstone Agent List",
+    description:
+      "List all skcapstone agent profiles available on this node. Each profile has its own identity, memories, soul, and trust state. Use this to discover which agents can be loaded.",
+    parameters: { type: "object", properties: {} },
+    async execute() {
+      const result = runCli(SKCAPSTONE_BIN, "agents list --json");
+      return textResult(result.output);
+    },
+  };
+}
+
+function createSKCapstoneAgentStatusTool() {
+  return {
+    name: "skcapstone_agent_status",
+    label: "SKCapstone Agent Status",
+    description:
+      "Show the status of a specific skcapstone agent profile — identity, memories, trust, sync state. Use this to load a different agent's context into the current OpenClaw session.",
+    parameters: {
+      type: "object",
+      required: ["agent"],
+      properties: {
+        agent: { type: "string", description: "Agent name (e.g. 'lumina', 'opus', 'jarvis')." },
+      },
+    },
+    async execute(_id: string, params: Record<string, unknown>) {
+      const agent = String(params.agent ?? "");
+      const result = runCli(SKCAPSTONE_BIN, `status --agent ${escapeShellArg(agent)}`, agent);
+      return textResult(result.output);
+    },
+  };
+}
+
+function createSKCapstoneAgentCreateTool() {
+  return {
+    name: "skcapstone_agent_create",
+    label: "SKCapstone Create Agent",
+    description:
+      "Create a new skcapstone agent profile with its own identity, memory store, and sync folder. The profile will immediately begin syncing via Syncthing to all connected nodes.",
+    parameters: {
+      type: "object",
+      required: ["name"],
+      properties: {
+        name: { type: "string", description: "Agent name (lowercase, e.g. 'casey', 'nova')." },
+      },
+    },
+    async execute(_id: string, params: Record<string, unknown>) {
+      const name = String(params.name ?? "").toLowerCase();
+      const result = runCli(SKCAPSTONE_BIN, `init --name ${escapeShellArg(name)} --agent ${escapeShellArg(name)}`);
+      return textResult(result.output);
+    },
+  };
+}
+
 // ── Plugin registration ─────────────────────────────────────────────────
 
 const skcapstonePlugin = {
@@ -324,6 +392,9 @@ const skcapstonePlugin = {
       createSKCapstoneSoulSwapTool(),
       createSKCapstoneSoulStatusTool(),
       createSKCapstoneSoulShowTool(),
+      createSKCapstoneAgentListTool(),
+      createSKCapstoneAgentStatusTool(),
+      createSKCapstoneAgentCreateTool(),
     ];
 
     for (const tool of tools) {
@@ -344,7 +415,7 @@ const skcapstonePlugin = {
       },
     });
 
-    api.logger.info?.(`👑 SKCapstone plugin registered (14 tools + /skcapstone command) [agent=${SKCAPSTONE_AGENT}]`);
+    api.logger.info?.(`SKCapstone plugin registered (17 tools + /skcapstone command) [agent=${SKCAPSTONE_AGENT}]`);
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smilintux/skcapstone",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "SKCapstone - The sovereign agent framework. CapAuth identity, Cloud 9 trust, SKMemory persistence.",
   "main": "index.js",
   "types": "index.d.ts",

package/scripts/install.ps1

@@ -162,6 +162,7 @@ Install-Pkg -Name 'skchat-sovereign' -Extras 'all'                -Paths @((Join
 Install-Pkg -Name 'skseal'     -Extras ''                         -Paths @((Join-Path $ParentDir 'skseal'))
 Install-Pkg -Name 'skskills'   -Extras ''                         -Paths @((Join-Path $ParentDir 'skskills'))
 Install-Pkg -Name 'sksecurity' -Extras ''                         -Paths @((Join-Path $ParentDir 'sksecurity'))
+Install-Pkg -Name 'skseed'     -Extras ''                         -Paths @((Join-Path $PillarDir 'skseed'), (Join-Path $ParentDir 'skseed'))
 
 # ---------------------------------------------------------------------------
 # Step 4: Dev tools (optional)
@@ -248,6 +249,6 @@ if ($failures -eq 0) {
     Write-Host "=== Installation complete with $failures warning(s) ===" -ForegroundColor Yellow
 }
 Write-Host ''
-Write-Host "Commands available: skcomm, skcapstone, capauth, skchat, skseal, skmemory, skskills, sksecurity"
+Write-Host "Commands available: skcomm, skcapstone, capauth, skchat, skseal, skmemory, skskills, sksecurity, skseed"
 Write-Host "Venv location:     $SKENV"
 Write-Host "To activate:       & $SKENV\Scripts\Activate.ps1"

package/scripts/install.sh

@@ -118,6 +118,7 @@ install_pkg "skchat-sovereign" "all"             "$PARENT/skchat"
 install_pkg "skseal"     ""                      "$PARENT/skseal"
 install_pkg "skskills"   ""                      "$PARENT/skskills"
 install_pkg "sksecurity" ""                      "$PARENT/sksecurity"
+install_pkg "skseed"     ""                      "$PILLAR/skseed $PARENT/skseed"
 
 # ---------------------------------------------------------------------------
 # Step 4: Dev tools (optional)
@@ -180,6 +181,6 @@ else
     echo "=== Installation complete with $failures warning(s) ==="
 fi
 echo ""
-echo "Commands available: skcomm, skcapstone, capauth, skchat, skseal, skmemory, skskills, sksecurity"
+echo "Commands available: skcomm, skcapstone, capauth, skchat, skseal, skmemory, skskills, sksecurity, skseed"
 echo "Venv location:     $SKENV"
 echo "To activate:       source $SKENV/bin/activate"

package/src/skcapstone/cli/_common.py

@@ -46,17 +46,17 @@ def resolve_agent_home(agent: str) -> Path:
 
 
 def apply_agent_override(agent: str) -> None:
-    """Override the global AGENT_HOME when --agent is specified.
+    """Set the active agent name when --agent is specified.
 
-    Mutates the package-level AGENT_HOME so that all downstream code
-    (MCP tools, pillars, etc.) uses the correct per-agent directory.
+    Only mutates SKCAPSTONE_AGENT so that agent_home() resolves to
+    the correct per-agent directory. Does NOT mutate AGENT_HOME
+    (the shared root) — that would break agent_home() (double
+    nesting) and shared_home() (wrong path).
 
     Args:
         agent: Agent name from the --agent CLI option or env var.
     """
     if agent:
-        new_home = str(Path(SHARED_ROOT) / "agents" / agent)
-        _pkg.AGENT_HOME = new_home
         _pkg.SKCAPSTONE_AGENT = agent
         os.environ["SKCAPSTONE_AGENT"] = agent
 

package/src/skcapstone/cli/status.py

@@ -209,7 +209,7 @@ def register_status_commands(main: click.Group) -> None:
                     "Run [bold]skcapstone init --name \"YourAgent\"[/] first."
                 )
                 sys.exit(1)
-            runtime = get_runtime(home_path)
+            runtime = get_runtime(home=home_path)
         else:
             agent_name = agent or default_agent
             runtime = get_runtime(agent_name=agent_name)

package/src/skcapstone/pillars/sync.py

@@ -72,7 +72,7 @@ def initialize_sync(home: Path, config: Optional[SyncConfig] = None) -> SyncStat
         else:
             state.status = PillarStatus.DEGRADED
 
-    state.seed_count = _count_seeds(sync_dir)
+    state.seed_count = _count_seeds(sync_dir, home=home)
     return state
 
 
@@ -396,7 +396,7 @@ def discover_sync(home: Path) -> SyncState:
     state = SyncState(
         transport=transport,
         sync_path=sync_dir,
-        seed_count=_count_seeds(sync_dir),
+        seed_count=_count_seeds(sync_dir, home=home),
         status=PillarStatus.ACTIVE,
     )
 
@@ -483,8 +483,8 @@ def _get_hostname() -> str:
     return socket.gethostname()
 
 
-def _count_seeds(sync_dir: Path) -> int:
-    """Count seed files across outbox, inbox, and archive."""
+def _count_seeds(sync_dir: Path, home: Optional[Path] = None) -> int:
+    """Count seed files across sync subdirs and the agent seeds directory."""
     count = 0
     for subdir in ("outbox", "inbox", "archive"):
         d = sync_dir / subdir
@@ -492,6 +492,13 @@ def _count_seeds(sync_dir: Path) -> int:
             count += sum(
                 1 for f in d.iterdir() if f.name.endswith(SEED_EXTENSION) or f.suffix == ".gpg"
             )
+    # Also count seeds in the agent's seeds/ directory
+    if home is not None:
+        seeds_dir = home / "seeds"
+        if seeds_dir.is_dir():
+            count += sum(
+                1 for f in seeds_dir.iterdir() if f.name.endswith(SEED_EXTENSION)
+            )
     return count
 
 

package/src/skcapstone/register.py

@@ -97,6 +97,13 @@ def _build_package_registry(workspace: Optional[Path] = None) -> list[dict]:
             "mcp_env": None,
             "openclaw_plugin_path": workspace / "pillar-repos" / "sksecurity" / "openclaw-plugin" / "src" / "index.ts",
         },
+        {
+            "name": "skseed",
+            "mcp_cmd": None,
+            "mcp_args": None,
+            "mcp_env": None,
+            "openclaw_plugin_path": workspace / "pillar-repos" / "skseed" / "openclaw-plugin" / "src" / "index.ts",
+        },
         {
             "name": "skgit",
             "mcp_cmd": "node",
@@ -119,6 +126,7 @@ _PILLAR_DIR_MAP: dict[str, Optional[str]] = {
     "capauth": "capauth",
     "cloud9": "cloud9-python",
     "sksecurity": "sksecurity",
+    "skseed": "skseed",
     "skgit": None,  # skill dir only, no pillar repo
 }
 

package/systemd/skcapstone.service

@@ -5,19 +5,18 @@ After=network-online.target ollama.service syncthing.service
 Wants=network-online.target
 
 [Service]
-Type=notify
-ExecStart=skcapstone daemon start --foreground
-ExecStop=skcapstone daemon stop
+Type=simple
+ExecStart=%h/.skenv/bin/skcapstone daemon start --foreground
+ExecStop=%h/.skenv/bin/skcapstone daemon stop
 ExecReload=/bin/kill -HUP $MAINPID
 Restart=on-failure
 RestartSec=10
-# Watchdog: daemon must call sd_notify("WATCHDOG=1") at least every 5 minutes
-WatchdogSec=300
 # Cap memory to prevent OOM from large model loading
 MemoryMax=4G
 # Keep Ollama models warm for 5 minutes between requests
 Environment=PYTHONUNBUFFERED=1
 Environment=OLLAMA_KEEP_ALIVE=5m
+Environment=SKCAPSTONE_AGENT=lumina
 # Journal logging
 StandardOutput=journal
 StandardError=journal
@@ -27,7 +26,7 @@ SyslogIdentifier=skcapstone
 NoNewPrivileges=true
 ProtectSystem=strict
 ProtectHome=read-only
-ReadWritePaths=%h/.skcapstone %h/.skmemory %h/.capauth %h/.cloud9 %h/.skcomm %h/.skchat
+ReadWritePaths=%h/.skcapstone %h/.skenv %h/.capauth %h/.cloud9 %h/.skcomm %h/.skchat
 PrivateTmp=true
 ProtectKernelTunables=true
 ProtectControlGroups=true