holomime 1.5.0 → 1.5.1

package/dist/cli.js

@@ -15892,6 +15892,8 @@ Intermediate results saved to ${chalk39.cyan(".holomime/pipeline/")}`,
 }
 
 // src/commands/live.ts
+import { deflateSync } from "zlib";
+import { execSync } from "child_process";
 import chalk40 from "chalk";
 
 // src/live/agent-detector.ts
@@ -16353,12 +16355,59 @@ function startServer(port) {
 }
 
 // src/commands/live.ts
+function encodeSnapshot(event, agentName) {
+  const compact = {
+    h: event.health,
+    g: event.grade,
+    m: event.messageCount,
+    a: agentName,
+    r: event.regions.filter((r) => r.intensity > 0).map((r) => ({ i: r.id, n: Math.round(r.intensity * 100) / 100 })),
+    p: event.patterns.map((p) => ({
+      i: p.id,
+      s: p.severity,
+      c: Math.round(p.percentage * 10) / 10
+    }))
+  };
+  const json = JSON.stringify(compact);
+  const compressed = deflateSync(Buffer.from(json));
+  return compressed.toString("base64url");
+}
+function copyToClipboard(text) {
+  try {
+    if (process.platform === "darwin") {
+      execSync("pbcopy", { input: text });
+      return true;
+    } else if (process.platform === "linux") {
+      execSync("xclip -selection clipboard", { input: text });
+      return true;
+    } else if (process.platform === "win32") {
+      execSync("clip", { input: text });
+      return true;
+    }
+  } catch {
+  }
+  return false;
+}
+function printShareLink(url, copied) {
+  console.log("");
+  console.log(
+    chalk40.green("  \u2713 ") + chalk40.bold("Brain snapshot captured!")
+  );
+  console.log("");
+  console.log("  " + chalk40.cyan(url));
+  console.log("");
+  if (copied) {
+    console.log(chalk40.dim("  Link copied to clipboard."));
+  }
+}
 async function liveCommand(options) {
   const port = options.port || 3838;
   let agent;
   if (options.watchPath) {
     agent = manualAgent(options.watchPath);
-    console.log(chalk40.green("  \u2713") + ` Manual watch: ${chalk40.dim(agent.logPath)}`);
+    console.log(
+      chalk40.green("  \u2713") + ` Manual watch: ${chalk40.dim(agent.logPath)}`
+    );
   } else {
     console.log(chalk40.dim("  Scanning for active agents..."));
     agent = detectAgent();
@@ -16366,19 +16415,69 @@ async function liveCommand(options) {
       console.log("");
       console.log(chalk40.red("  \u2717 No active agent detected."));
       console.log("");
-      console.log(chalk40.dim("  Make sure an AI coding agent is running, or specify a path:"));
-      console.log(chalk40.cyan("    holomime brain --watch <path-to-conversation-log>"));
+      console.log(
+        chalk40.dim(
+          "  Make sure an AI coding agent is running, or specify a path:"
+        )
+      );
+      console.log(
+        chalk40.cyan("    holomime brain --watch <path-to-conversation-log>")
+      );
       console.log("");
-      console.log(chalk40.dim("  Supported agents: Claude Code, Cline, OpenClaw, Codex, Cursor"));
+      console.log(
+        chalk40.dim("  Supported agents: Claude Code, Cline, OpenClaw, Codex, Cursor")
+      );
       process.exit(1);
     }
-    console.log(chalk40.green("  \u2713") + ` Detected ${chalk40.bold(agent.agent)} session`);
-    console.log(chalk40.green("  \u2713") + ` Watching: ${chalk40.dim(agent.logPath)}`);
+    console.log(
+      chalk40.green("  \u2713") + ` Detected ${chalk40.bold(agent.agent)} session`
+    );
+    console.log(
+      chalk40.green("  \u2713") + ` Watching: ${chalk40.dim(agent.logPath)}`
+    );
+  }
+  if (options.share) {
+    console.log(chalk40.dim("  Running diagnosis for snapshot..."));
+    let resolved = false;
+    await new Promise((resolve46) => {
+      const watcher2 = startWatcher(agent, {
+        onEvent(event) {
+          if (resolved) return;
+          resolved = true;
+          watcher2.stop();
+          const encoded = encodeSnapshot(event, agent.agent);
+          const url = `https://holomime.dev/brain?d=${encoded}`;
+          const copied = copyToClipboard(url);
+          printShareLink(url, copied);
+          resolve46();
+        },
+        onError(err) {
+          console.error(chalk40.red(`
+  \u2717 Error: ${err.message}`));
+          process.exit(1);
+        },
+        onReady() {
+        }
+      });
+      setTimeout(() => {
+        if (!resolved) {
+          resolved = true;
+          watcher2.stop();
+          console.log(
+            chalk40.red("  \u2717 No diagnosis data available. Is the agent active?")
+          );
+          process.exit(1);
+        }
+      }, 1e4);
+    });
+    process.exit(0);
   }
   let server;
   try {
     server = await startServer(port);
-    console.log(chalk40.green("  \u2713") + ` NeuralSpace: ${chalk40.cyan(`http://localhost:${server.port}`)}`);
+    console.log(
+      chalk40.green("  \u2713") + ` NeuralSpace: ${chalk40.cyan(`http://localhost:${server.port}`)}`
+    );
   } catch (err) {
     console.log(chalk40.red(`  \u2717 ${err.message}`));
     process.exit(1);
@@ -16397,21 +16496,21 @@ async function liveCommand(options) {
     } catch {
     }
   }
-  let lastHealth = 100;
-  let lastPatternCount = 0;
+  let lastEvent = null;
   let msgCount = 0;
   const watcher = startWatcher(agent, {
     onEvent(event) {
       server.broadcast(event);
+      lastEvent = event;
       msgCount = event.messageCount;
-      lastHealth = event.health;
-      lastPatternCount = event.patterns.length;
       const healthColor = event.health >= 85 ? chalk40.green : event.health >= 70 ? chalk40.yellow : event.health >= 50 ? chalk40.hex("#f97316") : chalk40.red;
       const patternStr = event.patterns.length > 0 ? event.patterns.map((p) => {
         const c = p.severity === "concern" ? chalk40.red : p.severity === "warning" ? chalk40.yellow : chalk40.dim;
         return c(p.id);
       }).join(", ") : chalk40.green("none");
-      process.stdout.write(`\r  ${chalk40.dim("\u2502")} Health: ${healthColor(`${event.health}/100`)} (${event.grade}) ${chalk40.dim("\u2502")} Patterns: ${patternStr} ${chalk40.dim("\u2502")} Messages: ${chalk40.white(String(msgCount))}    `);
+      process.stdout.write(
+        `\r  ${chalk40.dim("\u2502")} Health: ${healthColor(`${event.health}/100`)} (${event.grade}) ${chalk40.dim("\u2502")} Patterns: ${patternStr} ${chalk40.dim("\u2502")} Messages: ${chalk40.white(String(msgCount))}    `
+      );
     },
     onError(err) {
       console.error(chalk40.red(`
@@ -16419,13 +16518,35 @@ async function liveCommand(options) {
     },
     onReady() {
       console.log("");
-      console.log(chalk40.green("  \u25CF ") + chalk40.bold("Monitoring agent behavior in real-time"));
-      console.log(chalk40.dim("  \u2502 Press Ctrl+C to stop"));
+      console.log(
+        chalk40.green("  \u25CF ") + chalk40.bold("Monitoring agent behavior in real-time")
+      );
+      console.log(
+        chalk40.dim("  \u2502 Press Ctrl+C to stop") + chalk40.dim(" \xB7 Press s to share snapshot")
+      );
       console.log("");
     }
   });
+  if (process.stdin.isTTY) {
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on("data", (data) => {
+      const key = data.toString();
+      if (key === "") {
+        shutdown();
+        return;
+      }
+      if ((key === "s" || key === "S") && lastEvent) {
+        const encoded = encodeSnapshot(lastEvent, agent.agent);
+        const url = `https://holomime.dev/brain?d=${encoded}`;
+        const copied = copyToClipboard(url);
+        printShareLink(url, copied);
+      }
+    });
+  }
   const shutdown = () => {
     console.log(chalk40.dim("\n\n  Stopping..."));
+    if (process.stdin.isTTY) process.stdin.setRawMode(false);
     watcher.stop();
     server.close();
     process.exit(0);
@@ -16503,11 +16624,12 @@ program.command("interview").description("Self-awareness interview \u2014 score
 program.command("prescribe").description("Diagnose and prescribe DPO treatments from the behavioral corpus [Pro]").requiredOption("--personality <path>", "Path to .personality.json").requiredOption("--log <path>", "Path to conversation log").option("--format <format>", "Log format (holomime, chatgpt, claude, openai-api, anthropic-api, otel, jsonl)").option("--source <source>", "Correction source (corpus, marketplace, both)", "corpus").option("--apply", "Apply found treatments").option("-o, --output <path>", "Write prescription to file").action(prescribeCommand);
 program.command("voice").description("Monitor voice conversations for behavioral drift in real-time [Pro]").requiredOption("--personality <path>", "Path to .personality.json").option("--platform <name>", "Voice platform: livekit, vapi, retell, generic", "generic").option("--room <name>", "LiveKit room name").option("--server-url <url>", "LiveKit server URL").option("--webhook-port <port>", "Vapi webhook port (default: 3001)").option("--agent-id <id>", "Retell agent ID").option("--input <path>", "Input transcript file (JSONL) for offline analysis").option("--interval <ms>", "Diagnosis interval in milliseconds (default: 15000)").option("--threshold <level>", "Alert threshold: warning or concern (default: warning)").action(voiceCommand);
 program.command("cure").description("End-to-end behavioral fix: diagnose \u2192 export \u2192 train \u2192 verify [Pro]").requiredOption("--personality <path>", "Path to .personality.json").requiredOption("--log <path>", "Path to conversation log (JSON)").option("--provider <provider>", "Training provider (openai, huggingface)", "openai").option("--base-model <model>", "Base model to fine-tune", "gpt-4o-mini-2024-07-18").option("--method <method>", "Training method (auto, sft, dpo)", "auto").option("--epochs <n>", "Number of training epochs").option("--suffix <name>", "Model name suffix").option("--skip-train", "Skip training step (diagnose + export only)").option("--skip-verify", "Skip post-training verification").option("--dry-run", "Preview pipeline plan without executing").option("--push", "Push trained model to HuggingFace Hub").option("--hub-repo <repo>", "HuggingFace Hub repo (user/model-name)").option("--pass-threshold <n>", "Minimum verification score (0-100)", "50").action(cureCommand);
-program.command("brain").description("See your agent's brain \u2014 real-time NeuralSpace visualization [Pro]").option("--watch <path>", "Manual path to conversation log file").option("--agent <agent>", "Agent type override (claude-code, cline, manual)").option("--port <port>", "Server port (default: 3838)", "3838").option("--no-open", "Don't auto-open browser").option("--personality <path>", "Personality spec for assessment context").action((opts) => liveCommand({
+program.command("brain").description("See your agent's brain \u2014 real-time NeuralSpace visualization [Pro]").option("--watch <path>", "Manual path to conversation log file").option("--agent <agent>", "Agent type override (claude-code, cline, manual)").option("--port <port>", "Server port (default: 3838)", "3838").option("--no-open", "Don't auto-open browser").option("--share", "Capture a brain snapshot and generate a shareable link").option("--personality <path>", "Personality spec for assessment context").action((opts) => liveCommand({
   watchPath: opts.watch,
   agent: opts.agent,
   port: parseInt(opts.port, 10),
   noOpen: opts.open === false,
+  share: opts.share === true,
   personality: opts.personality
 }));
 program.parseAsync().then(() => flushTelemetry());

package/dist/neuralspace/index.html

@@ -5,6 +5,7 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>NeuralSpace — HoloMime Brain</title>
   <link rel="stylesheet" href="styles.css">
+  <script src="https://cdn.jsdelivr.net/npm/pako@2.1.0/dist/pako_inflate.min.js"></script>
   <script type="importmap">
   { "imports": {
     "three": "https://cdn.jsdelivr.net/npm/three@0.172.0/build/three.module.js",
@@ -57,6 +58,12 @@
         <span>Reconnecting to agent...</span>
       </div>
 
+      <div id="snapshot-cta">
+        <span>See your own agent's brain</span>
+        <code>npx holomime brain</code>
+        <a href="https://holomime.dev/brain">Learn more</a>
+      </div>
+
       <div id="watermark">Powered by HoloMime</div>
     </div>
 

package/dist/neuralspace/neuralspace.js

@@ -832,8 +832,71 @@ function animate(){
   composer.render();
 }
 
+// ═══════════ SNAPSHOT MODE ═══════════
+
+function initSnapshot(encoded) {
+  try {
+    // Decode base64url → Uint8Array → inflate → JSON
+    const b64 = encoded.replace(/-/g, '+').replace(/_/g, '/');
+    const bin = atob(b64);
+    const bytes = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
+    const inflated = window.pako.inflate(bytes, { to: 'string' });
+    const compact = JSON.parse(inflated);
+
+    // Expand compact format → full BrainEvent
+    const event = {
+      type: 'diagnosis',
+      timestamp: new Date().toISOString(),
+      health: compact.h,
+      grade: compact.g,
+      messageCount: compact.m || 0,
+      regions: (compact.r || []).map(r => ({
+        id: r.i,
+        intensity: r.n,
+        patterns: [],
+      })),
+      patterns: (compact.p || []).map(p => ({
+        id: p.i,
+        name: p.i.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase()),
+        severity: p.s,
+        percentage: p.c,
+        description: '',
+      })),
+      activity: null,
+    };
+
+    // Update UI
+    handleInit({ type: 'init', agent: compact.a || 'unknown', sessionPath: 'snapshot', startedAt: new Date().toISOString() });
+    handleDiagnosis(event);
+
+    // Update status to "Snapshot"
+    statusEl.className = 'status-badge';
+    statusEl.querySelector('span').textContent = 'Snapshot';
+    statusEl.querySelector('.status-dot').style.background = 'var(--accent)';
+    statusEl.querySelector('.status-dot').style.boxShadow = '0 0 8px var(--accent)';
+    statusEl.querySelector('.status-dot').style.animation = 'none';
+
+    // Show snapshot CTA
+    const ctaEl = document.getElementById('snapshot-cta');
+    if (ctaEl) ctaEl.classList.add('visible');
+
+  } catch (err) {
+    console.error('Failed to decode snapshot:', err);
+    statusEl.className = 'status-badge disconnected';
+    statusEl.querySelector('span').textContent = 'Invalid snapshot';
+  }
+}
+
 // ═══════════ INIT ═══════════
 
 updateHealth(100, 'A');
-connect();
+
+const urlParams = new URLSearchParams(window.location.search);
+const snapshotParam = urlParams.get('d');
+if (snapshotParam) {
+  initSnapshot(snapshotParam);
+} else {
+  connect();
+}
 animate();

package/dist/neuralspace/styles.css

@@ -479,6 +479,51 @@ body {
   to { transform: rotate(360deg); }
 }
 
+/* ─── Snapshot CTA ─── */
+#snapshot-cta {
+  position: absolute;
+  bottom: 20px;
+  left: 50%;
+  transform: translateX(-50%);
+  z-index: 20;
+  background: var(--bg-panel);
+  border: 1px solid var(--border);
+  border-radius: 10px;
+  padding: 12px 24px;
+  display: none;
+  align-items: center;
+  gap: 12px;
+  -webkit-backdrop-filter: blur(12px);
+  backdrop-filter: blur(12px);
+  animation: fadeIn 0.5s ease 0.5s both;
+}
+
+#snapshot-cta.visible { display: flex; }
+
+#snapshot-cta span {
+  font-size: 13px;
+  color: var(--text);
+  font-weight: 500;
+}
+
+#snapshot-cta code {
+  font-family: var(--mono);
+  font-size: 13px;
+  color: #06b6d4;
+  background: rgba(6,182,212,0.1);
+  padding: 4px 10px;
+  border-radius: 6px;
+  border: 1px solid rgba(6,182,212,0.2);
+}
+
+#snapshot-cta a {
+  font-size: 12px;
+  color: var(--accent);
+  text-decoration: none;
+}
+
+#snapshot-cta a:hover { text-decoration: underline; }
+
 /* ─── Scrollbar ─── */
 ::-webkit-scrollbar { width: 4px; }
 ::-webkit-scrollbar-track { background: transparent; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holomime",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "Behavioral therapy infrastructure for AI agents — Big Five psychology, structured treatment, DPO training data",
   "type": "module",
   "bin": {