@geravant/sinain 1.0.19 → 1.2.0

package/README.md

@@ -1,4 +1,13 @@
-# sinain-hud OpenClaw Plugin
+# @geravant/sinain
+
+This package serves two roles:
+
+1. **Standalone launcher** — run `npx @geravant/sinain start` to launch the full sinain stack (core, sense, overlay, agent) on your Mac. See the [main README](../README.md#quick-start) for usage.
+2. **OpenClaw plugin** — when installed on an OpenClaw gateway server (`npx @geravant/sinain install`), it manages the sinain-hud agent lifecycle.
+
+---
+
+## OpenClaw Plugin
 
 Plugin for the [anthillnet fork of OpenClaw](https://github.com/anthillnet/openclaw) that manages the sinain-hud agent lifecycle on the server.
 

package/cli.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import { execSync } from "child_process";
+import net from "net";
+import os from "os";
+import fs from "fs";
+import path from "path";
+
+const cmd = process.argv[2];
+
+switch (cmd) {
+  case "start":
+    await import("./launcher.js");
+    break;
+
+  case "stop":
+    await stopServices();
+    break;
+
+  case "status":
+    await showStatus();
+    break;
+
+  case "setup-overlay":
+    await import("./setup-overlay.js");
+    break;
+
+  case "install":
+    // --if-openclaw: only run if OpenClaw is installed (for postinstall)
+    if (process.argv.includes("--if-openclaw")) {
+      const ocJson = path.join(os.homedir(), ".openclaw/openclaw.json");
+      if (!fs.existsSync(ocJson)) {
+        console.log("  OpenClaw not detected — skipping plugin install");
+        process.exit(0);
+      }
+    }
+    await import("./install.js");
+    break;
+
+  default:
+    printUsage();
+    break;
+}
+
+// ── Stop ──────────────────────────────────────────────────────────────────────
+
+async function stopServices() {
+  let killed = false;
+
+  const patterns = [
+    "tsx.*src/index.ts",
+    "tsx watch src/index.ts",
+    "python3 -m sense_client",
+    "Python -m sense_client",
+    "flutter run -d macos",
+    "sinain_hud.app/Contents/MacOS/sinain_hud",
+    "sinain-agent/run.sh",
+  ];
+
+  for (const pat of patterns) {
+    try {
+      execSync(`pkill -f "${pat}"`, { stdio: "pipe" });
+      killed = true;
+    } catch { /* not running */ }
+  }
+
+  // Free port 9500
+  try {
+    const pid = execSync("lsof -i :9500 -sTCP:LISTEN -t", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    if (pid) {
+      execSync(`kill ${pid}`, { stdio: "pipe" });
+      killed = true;
+    }
+  } catch { /* port already free */ }
+
+  // Clean PID file
+  const pidFile = "/tmp/sinain-pids.txt";
+  if (fs.existsSync(pidFile)) {
+    fs.unlinkSync(pidFile);
+  }
+
+  if (killed) {
+    console.log("sinain services stopped.");
+  } else {
+    console.log("No sinain services were running.");
+  }
+}
+
+// ── Status ────────────────────────────────────────────────────────────────────
+
+async function showStatus() {
+  const CYAN = "\x1b[36m";
+  const YELLOW = "\x1b[33m";
+  const MAGENTA = "\x1b[35m";
+  const GREEN = "\x1b[32m";
+  const RED = "\x1b[31m";
+  const BOLD = "\x1b[1m";
+  const DIM = "\x1b[2m";
+  const RESET = "\x1b[0m";
+
+  console.log(`\n${BOLD}── SinainHUD Status ────────────────────${RESET}`);
+
+  // Core: check port 9500
+  const coreUp = await isPortOpen(9500);
+  if (coreUp) {
+    console.log(`  ${CYAN}core${RESET}     :9500   ${GREEN}✓${RESET}  running`);
+  } else {
+    console.log(`  ${CYAN}core${RESET}     :9500   ${RED}✗${RESET}  stopped`);
+  }
+
+  // Sense: check pgrep
+  const senseUp = isProcessRunning("python3 -m sense_client") || isProcessRunning("Python -m sense_client");
+  if (senseUp) {
+    console.log(`  ${YELLOW}sense${RESET}            ${GREEN}✓${RESET}  running`);
+  } else {
+    console.log(`  ${YELLOW}sense${RESET}            ${DIM}—  stopped${RESET}`);
+  }
+
+  // Overlay
+  const overlayUp = isProcessRunning("sinain_hud.app") || isProcessRunning("flutter run -d macos");
+  if (overlayUp) {
+    console.log(`  ${MAGENTA}overlay${RESET}          ${GREEN}✓${RESET}  running`);
+  } else {
+    console.log(`  ${MAGENTA}overlay${RESET}          ${DIM}—  stopped${RESET}`);
+  }
+
+  // Agent
+  const agentUp = isProcessRunning("sinain-agent/run.sh");
+  if (agentUp) {
+    console.log(`  ${GREEN}agent${RESET}            ${GREEN}✓${RESET}  running`);
+  } else {
+    console.log(`  ${GREEN}agent${RESET}            ${DIM}—  stopped${RESET}`);
+  }
+
+  console.log(`${BOLD}────────────────────────────────────────${RESET}\n`);
+}
+
+function isPortOpen(port) {
+  return new Promise((resolve) => {
+    const sock = new net.Socket();
+    sock.setTimeout(500);
+    sock.on("connect", () => { sock.destroy(); resolve(true); });
+    sock.on("error", () => resolve(false));
+    sock.on("timeout", () => { sock.destroy(); resolve(false); });
+    sock.connect(port, "127.0.0.1");
+  });
+}
+
+function isProcessRunning(pattern) {
+  try {
+    execSync(`pgrep -f "${pattern}"`, { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ── Usage ─────────────────────────────────────────────────────────────────────
+
+function printUsage() {
+  console.log(`
+sinain — AI overlay system for macOS
+
+Usage:
+  sinain start [options]       Launch sinain services
+  sinain stop                  Stop all sinain services
+  sinain status                Check what's running
+  sinain setup-overlay         Clone and build the overlay app
+  sinain install               Install OpenClaw plugin (server-side)
+
+Start options:
+  --no-sense                   Skip screen capture (sense_client)
+  --no-overlay                 Skip Flutter overlay
+  --no-agent                   Skip agent poll loop
+  --agent=<name>               Agent to use: claude, codex, goose, aider (default: claude)
+`);
+}

package/index.ts

@@ -560,8 +560,10 @@ export default function sinainHudPlugin(api: OpenClawPluginApi): void {
           `sinain-hud: session summary written (${toolCount} tools, ${Math.round(durationMs / 1000)}s)`,
         );
 
-        // Fire-and-forget: ingest session summary into triple store
-        if (state.workspaceDir) {
+        // Fire-and-forget: ingest session summary into knowledge graph
+        // NOTE: Main knowledge integration happens in heartbeat tick (session_distiller + knowledge_integrator).
+        // This is a lightweight best-effort path for when agent_end fires (won't fire on kill).
+        if (false && state.workspaceDir) {
           api.runtime.system.runCommandWithTimeout(
             ["uv", "run", "--with", "requests", "python3",
              "sinain-memory/triple_ingest.py",

package/install.js

@@ -3,6 +3,7 @@ import fs from "fs";
 import path from "path";
 import os from "os";
 import { execSync } from "child_process";
+import { randomBytes } from "crypto";
 
 const HOME        = os.homedir();
 const PLUGIN_DIR  = path.join(HOME, ".openclaw/extensions/sinain-hud");
@@ -18,7 +19,9 @@ const SKILL      = path.join(PKG_DIR, "SKILL.md");
 
 console.log("\nInstalling sinain plugin...");
 
-// 1. Stage plugin files to local ~/.openclaw (used by both paths)
+// 1. Copy plugin files (remove stale extensions/sinain dir if present from old installs)
+const stalePluginDir = path.join(HOME, ".openclaw/extensions/sinain");
+if (fs.existsSync(stalePluginDir)) fs.rmSync(stalePluginDir, { recursive: true, force: true });
 fs.mkdirSync(PLUGIN_DIR, { recursive: true });
 fs.copyFileSync(path.join(PKG_DIR, "index.ts"),             path.join(PLUGIN_DIR, "index.ts"));
 fs.copyFileSync(path.join(PKG_DIR, "openclaw.plugin.json"), path.join(PLUGIN_DIR, "openclaw.plugin.json"));
@@ -115,13 +118,15 @@ async function installNemoClaw({ sandboxName }) {
       sessionKey:    "agent:main:sinain"
     }
   };
+  // Remove stale "sinain" entry if present from a previous install
+  delete cfg.plugins.entries["sinain"];
   if (!cfg.plugins.allow.includes("sinain-hud")) cfg.plugins.allow.push("sinain-hud");
   cfg.agents                                         ??= {};
   cfg.agents.defaults                                ??= {};
   cfg.agents.defaults.sandbox                        ??= {};
   cfg.agents.defaults.sandbox.sessionToolsVisibility  = "all";
   // NemoClaw: gateway bind/auth are managed by OpenShell — but compaction must be set explicitly
-  cfg.compaction = { mode: "safeguard", maxHistoryShare: 0.2, reserveTokensFloor: 40000 };
+  cfg.agents.defaults.compaction = { mode: "safeguard", maxHistoryShare: 0.2, reserveTokensFloor: 40000 };
 
   const token = cfg.gateway?.auth?.token ?? "(see sandbox openclaw.json)";
 
@@ -145,6 +150,19 @@ async function installNemoClaw({ sandboxName }) {
     }
   }
 
+  // Knowledge snapshot repo (optional) — inside sandbox
+  const snapshotUrl = process.env.SINAIN_SNAPSHOT_REPO;
+  if (snapshotUrl) {
+    try {
+      await checkRepoPrivacy(snapshotUrl);
+      run(`ssh -T openshell-${sandboxName} 'mkdir -p ~/.sinain/knowledge-snapshots && cd ~/.sinain/knowledge-snapshots && ([ -d .git ] || (git init && git config user.name sinain-knowledge && git config user.email sinain@local)) && (git remote get-url origin >/dev/null 2>&1 && git remote set-url origin "${snapshotUrl}" || git remote add origin "${snapshotUrl}") && (git fetch origin && git checkout -B main origin/main) 2>/dev/null || true'`);
+      console.log("  ✓ Snapshot repo configured in sandbox");
+    } catch (e) {
+      console.error("\n  ✗ Snapshot repo setup aborted:", e.message, "\n");
+      process.exit(1);
+    }
+  }
+
   // Restart openclaw gateway inside sandbox (kill existing PID + start fresh)
   try {
     // Find the gateway PID, kill it, then start a new instance detached
@@ -201,19 +219,32 @@ async function installLocal() {
       sessionKey:    "agent:main:sinain"
     }
   };
+  // Remove stale "sinain" entry if present from a previous install
+  delete cfg.plugins.entries["sinain"];
+  cfg.plugins.allow ??= [];
+  if (!cfg.plugins.allow.includes("sinain-hud")) cfg.plugins.allow.push("sinain-hud");
   cfg.agents                                         ??= {};
   cfg.agents.defaults                                ??= {};
   cfg.agents.defaults.sandbox                        ??= {};
   cfg.agents.defaults.sandbox.sessionToolsVisibility  = "all";
-  cfg.compaction = { mode: "safeguard", maxHistoryShare: 0.2, reserveTokensFloor: 40000 };
+  cfg.agents.defaults.compaction = { mode: "safeguard", maxHistoryShare: 0.2, reserveTokensFloor: 40000 };
   cfg.gateway     ??= {};
   cfg.gateway.bind  = "lan";  // allow remote Mac to connect
 
+  // Propagate snapshot repo path to plugin config (used for periodic git-backed knowledge backups)
+  if (process.env.SINAIN_SNAPSHOT_REPO) {
+    cfg.plugins.entries["sinain-hud"].config.snapshotRepoPath = process.env.SINAIN_SNAPSHOT_REPO;
+  }
+
   fs.mkdirSync(path.dirname(OC_JSON), { recursive: true });
   fs.writeFileSync(OC_JSON, JSON.stringify(cfg, null, 2));
   console.log("  ✓ openclaw.json patched");
 
   // Memory restore from backup repo
+  // Set SINAIN_BACKUP_REPO to a private GitHub repo URL to seed the workspace with
+  // existing memory (session summaries, playbook, triplestore, identity files).
+  // Expected repo structure: memory/, playbook.md, identity/, triplestore.jsonl, SITUATION.md
+  // The repo MUST be private — the installer verifies this via GitHub API.
   const backupUrl = process.env.SINAIN_BACKUP_REPO;
   if (backupUrl) {
     try {
@@ -232,25 +263,69 @@ async function installLocal() {
     }
   }
 
-  // Reload gateway
+  // Knowledge snapshot repo (optional)
+  await setupSnapshotRepo();
+
+  // Start / restart gateway
   try {
-    execSync("openclaw reload", { stdio: "pipe" });
-    console.log("  ✓ Gateway reloaded");
+    execSync("openclaw gateway restart --background", { stdio: "pipe" });
+    console.log("  ✓ Gateway restarted");
   } catch {
     try {
-      execSync("openclaw stop && sleep 1 && openclaw start --background", { stdio: "pipe" });
-      console.log("  ✓ Gateway restarted");
+      execSync("openclaw gateway start --background", { stdio: "pipe" });
+      console.log("  ✓ Gateway started");
     } catch {
       console.warn("  ⚠ Could not start gateway — run: openclaw gateway");
     }
   }
 
-  console.log(`
-✓ sinain installed successfully.
-  Plugin config: ~/.openclaw/openclaw.json
-  Auth token:    check your Brev dashboard → 'Gateway Token'
-  Then run ./setup-nemoclaw.sh on your Mac.
-`);
+  console.log("\n✓ sinain installed successfully.");
+  console.log("  Plugin config: ~/.openclaw/openclaw.json");
+  console.log(`  Auth token:    ${authToken}`);
+  console.log("  Next: run 'openclaw gateway' in a new terminal, then run ./setup-nemoclaw.sh on your Mac.\n");
+}
+
+// ── Knowledge snapshot repo setup (shared) ──────────────────────────────────
+
+const SNAPSHOT_DIR = path.join(HOME, ".sinain", "knowledge-snapshots");
+
+async function setupSnapshotRepo() {
+  const snapshotUrl = process.env.SINAIN_SNAPSHOT_REPO;
+  if (!snapshotUrl) return;
+
+  try {
+    await checkRepoPrivacy(snapshotUrl);
+    fs.mkdirSync(SNAPSHOT_DIR, { recursive: true });
+
+    if (!fs.existsSync(path.join(SNAPSHOT_DIR, ".git"))) {
+      execSync(`git init "${SNAPSHOT_DIR}"`, { stdio: "pipe" });
+      execSync(`git -C "${SNAPSHOT_DIR}" config user.name "sinain-knowledge"`, { stdio: "pipe" });
+      execSync(`git -C "${SNAPSHOT_DIR}" config user.email "sinain@local"`, { stdio: "pipe" });
+    }
+
+    // Set remote (add or update)
+    try {
+      run_capture(`git -C "${SNAPSHOT_DIR}" remote get-url origin`);
+      execSync(`git -C "${SNAPSHOT_DIR}" remote set-url origin "${snapshotUrl}"`, { stdio: "pipe" });
+    } catch {
+      execSync(`git -C "${SNAPSHOT_DIR}" remote add origin "${snapshotUrl}"`, { stdio: "pipe" });
+    }
+
+    // Pull existing snapshots if remote has content
+    try {
+      execSync(`git -C "${SNAPSHOT_DIR}" fetch origin`, { stdio: "pipe", timeout: 15_000 });
+      execSync(`git -C "${SNAPSHOT_DIR}" checkout -B main origin/main`, { stdio: "pipe" });
+      console.log("  ✓ Snapshot repo restored from", snapshotUrl);
+    } catch {
+      console.log("  ✓ Snapshot repo configured (empty remote)");
+    }
+  } catch (e) {
+    if (e.message?.startsWith("SECURITY") || e.message?.startsWith("Refusing")) {
+      console.error("\n  ✗ Snapshot repo setup aborted:", e.message, "\n");
+      process.exit(1);
+    }
+    console.warn("  ⚠ Snapshot repo setup failed:", e.message);
+  }
 }
 
 // ── Detection ────────────────────────────────────────────────────────────────