@deeplake/hivemind 0.7.67 → 0.7.69

package/.claude-plugin/marketplace.json

@@ -6,18 +6,18 @@
   },
   "metadata": {
     "description": "Cloud-backed persistent shared memory for AI agents powered by Deeplake",
-    "version": "0.7.67"
+    "version": "0.7.69"
   },
   "plugins": [
     {
       "name": "hivemind",
       "description": "Persistent shared memory powered by Deeplake — captures all session activity and provides cross-session, cross-agent memory search",
-      "version": "0.7.67",
+      "version": "0.7.69",
       "source": {
         "source": "git-subdir",
         "url": "https://github.com/activeloopai/hivemind.git",
         "path": "claude-code",
-        "sha": "7d1de6ab6b8a13bc52305e69d1a8ccc0b6e4d92a"
+        "sha": "fcce30444cbb853f2f6748aaf7422abbcf3e774a"
       },
       "homepage": "https://github.com/activeloopai/hivemind"
     }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "hivemind",
   "description": "Cloud-backed persistent memory powered by Deeplake — read, write, and share memory across Claude Code sessions and agents",
-  "version": "0.7.67",
+  "version": "0.7.69",
   "author": {
     "name": "Activeloop",
     "url": "https://deeplake.ai"

package/README.md

@@ -173,6 +173,20 @@ git clone https://github.com/activeloopai/hivemind.git ~/.codex/hivemind
 ```
 
 Restart Codex to activate.
+
+**First launch — trust the hooks.** Codex shows a **"Hooks need review"** prompt before it will run hivemind's hooks:
+
+```text
+Hooks need review
+2 hooks are new or changed.
+Hooks can run outside the sandbox after you trust them.
+
+   1. Review hooks
+ › 2. Trust all and continue
+   3. Continue without trusting (hooks won't run)
+```
+
+Choose **`2. Trust all and continue`** — otherwise the hooks won't run and hivemind stays inactive.
 </details>
 
 <details>

package/bundle/cli.js

@@ -114,6 +114,19 @@ function writeJson(path, obj) {
   ensureDir(dirname(path));
   writeFileSync(path, JSON.stringify(obj, null, 2) + "\n");
 }
+function writeJsonIfChanged(path, obj) {
+  const next = JSON.stringify(obj, null, 2) + "\n";
+  if (existsSync(path)) {
+    try {
+      if (readFileSync(path, "utf-8") === next)
+        return false;
+    } catch {
+    }
+  }
+  ensureDir(dirname(path));
+  writeFileSync(path, next);
+  return true;
+}
 function writeVersionStamp(dir, version) {
   ensureDir(dir);
   writeFileSync(join(dir, ".hivemind_version"), version);
@@ -486,7 +499,9 @@ function installCodex() {
   if (existsSync3(srcSkills))
     copyDir(srcSkills, join4(PLUGIN_DIR, "skills"));
   tryEnableCodexHooks();
-  writeJson(HOOKS_PATH, mergeHooksJson(buildHooksJson()));
+  if (!writeJsonIfChanged(HOOKS_PATH, mergeHooksJson(buildHooksJson()))) {
+    log(`  Codex          hooks.json unchanged \u2014 skipped rewrite (no re-trust prompt)`);
+  }
   ensureDir(AGENTS_SKILLS_DIR);
   const skillTarget = join4(PLUGIN_DIR, "skills", "deeplake-memory");
   if (existsSync3(skillTarget)) {
@@ -753,7 +768,7 @@ function installCursor() {
   copyDir(srcBundle, join7(PLUGIN_DIR3, "bundle"));
   const existing = readJson(HOOKS_PATH2);
   const merged = mergeHooks2(existing);
-  writeJson(HOOKS_PATH2, merged);
+  writeJsonIfChanged(HOOKS_PATH2, merged);
   writeVersionStamp(PLUGIN_DIR3, getVersion());
   log(`  Cursor         installed -> ${PLUGIN_DIR3}`);
 }
@@ -10996,6 +11011,30 @@ async function runRulesCommand(args) {
 // dist/src/commands/goal.js
 import { randomUUID as randomUUID4 } from "node:crypto";
 var VALID_STATUS = /* @__PURE__ */ new Set(["opened", "in_progress", "closed"]);
+var VALID_AGENT = /* @__PURE__ */ new Set(["manual", "capture"]);
+function parseAgentFlag(args) {
+  const rest = [];
+  let agent = "manual";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--agent") {
+      const val = args[i + 1];
+      if (!val) {
+        process.stderr.write("usage: --agent requires a value (manual|capture)\n");
+        process.exit(1);
+      }
+      agent = val;
+      i++;
+      continue;
+    }
+    rest.push(args[i]);
+  }
+  if (!VALID_AGENT.has(agent)) {
+    process.stderr.write(`invalid --agent: ${agent} (expected manual|capture)
+`);
+    process.exit(1);
+  }
+  return { agent, rest };
+}
 function loadApiOrDie(table) {
   const cfg = loadConfig();
   if (!cfg) {
@@ -11006,7 +11045,7 @@ function loadApiOrDie(table) {
   const query = (sql) => api.query(sql);
   return { api, query, userName: cfg.userName };
 }
-async function goalAdd(text) {
+async function goalAdd(text, agent = "manual") {
   const cfg = loadConfig();
   if (!cfg) {
     process.stderr.write("hivemind: not logged in.\n");
@@ -11018,7 +11057,7 @@ async function goalAdd(text) {
   const safe = sqlIdent(table);
   const goalId = randomUUID4();
   const ts = (/* @__PURE__ */ new Date()).toISOString();
-  await query(`INSERT INTO "${safe}" (id, goal_id, owner, status, content, version, created_at, agent, plugin_version) VALUES ('${randomUUID4()}', '${sqlStr(goalId)}', '${sqlStr(cfg.userName)}', 'opened', E'${sqlStr(text)}', 1, '${sqlStr(ts)}', 'manual', '')`);
+  await query(`INSERT INTO "${safe}" (id, goal_id, owner, status, content, version, created_at, agent, plugin_version) VALUES ('${randomUUID4()}', '${sqlStr(goalId)}', '${sqlStr(cfg.userName)}', 'opened', E'${sqlStr(text)}', 1, '${sqlStr(ts)}', '${sqlStr(agent)}', '')`);
   process.stdout.write(`${goalId}
 `);
 }
@@ -11050,6 +11089,33 @@ async function goalList(filter) {
     process.exit(1);
   }
 }
+async function goalGet(goalId) {
+  if (!goalId) {
+    process.stderr.write("usage: hivemind goal get <goal_id>\n");
+    process.exit(1);
+  }
+  const cfg = loadConfig();
+  if (!cfg) {
+    process.stderr.write("not logged in\n");
+    process.exit(1);
+  }
+  const { query } = loadApiOrDie(cfg.goalsTableName);
+  const safe = sqlIdent(cfg.goalsTableName);
+  try {
+    const rows = await query(`SELECT content FROM "${safe}" WHERE goal_id = '${sqlStr(goalId)}' ORDER BY version DESC, created_at DESC LIMIT 1`);
+    if (rows.length === 0) {
+      process.stderr.write(`goal not found: ${goalId}
+`);
+      process.exit(1);
+    }
+    process.stdout.write(`${String(rows[0].content ?? "")}
+`);
+  } catch (e) {
+    process.stderr.write(`hivemind goal get: ${e.message}
+`);
+    process.exit(1);
+  }
+}
 async function goalDone(goalId) {
   await goalProgress(goalId, "closed");
 }
@@ -11171,8 +11237,10 @@ var USAGE_GOAL = `
 hivemind goal \u2014 manage team goals
 
 Usage:
-  hivemind goal add "<text>"            create a goal (status=opened)
+  hivemind goal add "<text>" [--agent manual|capture]
+                                        create a goal (status=opened)
   hivemind goal list [--all|--mine]     list goals (default: --mine)
+  hivemind goal get <goal_id>           print a goal's full body (resume context)
   hivemind goal done <goal_id>          mark goal closed
   hivemind goal progress <goal_id> <opened|in_progress|closed>
 `.trim();
@@ -11183,12 +11251,13 @@ async function runGoalCommand(args) {
     return;
   }
   if (sub === "add") {
-    const text = args.slice(1).join(" ").trim();
+    const { agent, rest } = parseAgentFlag(args.slice(1));
+    const text = rest.join(" ").trim();
     if (!text) {
       process.stderr.write('usage: hivemind goal add "<text>"\n');
       process.exit(1);
     }
-    await goalAdd(text);
+    await goalAdd(text, agent);
     return;
   }
   if (sub === "list") {
@@ -11196,6 +11265,15 @@ async function runGoalCommand(args) {
     await goalList(filter);
     return;
   }
+  if (sub === "get") {
+    const id = args[1];
+    if (!id) {
+      process.stderr.write("usage: hivemind goal get <goal_id>\n");
+      process.exit(1);
+    }
+    await goalGet(id);
+    return;
+  }
   if (sub === "done") {
     const id = args[1];
     if (!id) {

package/codex/bundle/capture.js

@@ -1843,6 +1843,9 @@ Format: **entity** (type) \u2014 what was done with it, its current state>
 ## Open Questions / TODO
 <Anything unresolved, blocked, or explicitly deferred>
 
+## Next Steps
+<The single concrete next action to resume with, as one imperative line (e.g. "Wire the resume-brief Next Steps fallback and run the tests"). If the session reached a clean stopping point with nothing pending, write exactly: none>
+
 IMPORTANT: Be exhaustive. Extract EVERY entity, decision, and fact.
 PRIVACY: Never include absolute filesystem paths in the summary.
 LENGTH LIMIT: Keep the total summary under 4000 characters.`;

package/codex/bundle/stop.js

@@ -1123,6 +1123,9 @@ Format: **entity** (type) \u2014 what was done with it, its current state>
 ## Open Questions / TODO
 <Anything unresolved, blocked, or explicitly deferred>
 
+## Next Steps
+<The single concrete next action to resume with, as one imperative line (e.g. "Wire the resume-brief Next Steps fallback and run the tests"). If the session reached a clean stopping point with nothing pending, write exactly: none>
+
 IMPORTANT: Be exhaustive. Extract EVERY entity, decision, and fact.
 PRIVACY: Never include absolute filesystem paths in the summary.
 LENGTH LIMIT: Keep the total summary under 4000 characters.`;

package/codex/skills/hivemind-goals/SKILL.md

@@ -67,6 +67,36 @@ When the user expresses a new goal:
 
 **Do NOT auto-generate KPIs.** A goal is created with zero KPI files by default. Generate KPIs ONLY when the user explicitly asks you to ("aggiungi KPI per …", "add metrics for this goal", "track these metrics: …"). When the user asks, write each KPI as a separate file at `~/.deeplake/memory/kpi/<goal_id>/<kpi-slug>.md` with the body format documented above.
 
+### 1a. Capture a task for later (with resumable context)
+
+Use this when the user **parks a tangential task** mid-session — "save this for later", "remind me to …", "don't let me forget …", "let's do X later". The value is NOT the one-liner — it's storing enough **context to resume cold** in a future session without the user re-explaining anything.
+
+Write it via the **CLI** so the row is tagged `agent: capture`, which separates parked side-tasks from hand-made goals:
+
+```bash
+hivemind goal add --agent capture "Add rate-limiting to the webhook handler
+
+Start here: add a per-IP token bucket on the handler entry path
+Files: src/webhook/handler.ts:120-160, src/webhook/limits.ts
+Branch: feat/webhook-hardening
+Run: pnpm test webhook
+Why: bursty clients hammer the endpoint; agreed to defer until the retry-backoff work lands"
+```
+
+- **Line 1 is the label** — short; it's what `goal list` and the SessionStart banner show.
+- Fill `Start here / Files / Branch / Run / Why` from the live conversation. Include only the lines you can fill; `Start here:` (the concrete first action) matters most.
+- Pass the whole package as **one double-quoted argument** (newlines are preserved into the stored body).
+- Confirm to the user: the label + that it'll resume cleanly next session.
+
+### 1b. Resume a parked task (automatic context transfer)
+
+When the user says "let's work on that task / that goal", "let's start the `<X>` task", or "pick up the parked `<X>`", pull its stored context back into the session and continue — the user should NOT have to re-explain anything.
+
+1. **Find it:** `hivemind goal list --mine` and match the user's reference to a `goal_id`. If ambiguous, show the candidates and ask.
+2. **Transfer the context:** `hivemind goal get <goal_id>` prints the full package (`Start here / Files / Branch / Run / Why`). Read it as your working context — `goal list` only shows the first line, so always use `goal get` for the full body.
+3. **Flip to in_progress:** `mv ~/.deeplake/memory/goal/<owner>/opened/<uuid>.md ~/.deeplake/memory/goal/<owner>/in_progress/<uuid>.md`
+4. **Act on it:** open the `Files:`, switch to the `Branch:` if given, and begin from `Start here:`. You are resumed — continue as if the context was never lost.
+
 ### 2. List goals
 
 ```bash

package/cursor/bundle/capture.js

@@ -1843,6 +1843,9 @@ Format: **entity** (type) \u2014 what was done with it, its current state>
 ## Open Questions / TODO
 <Anything unresolved, blocked, or explicitly deferred>
 
+## Next Steps
+<The single concrete next action to resume with, as one imperative line (e.g. "Wire the resume-brief Next Steps fallback and run the tests"). If the session reached a clean stopping point with nothing pending, write exactly: none>
+
 IMPORTANT: Be exhaustive. Extract EVERY entity, decision, and fact.
 PRIVACY: Never include absolute filesystem paths in the summary.
 LENGTH LIMIT: Keep the total summary under 4000 characters.`;

package/cursor/bundle/session-end.js

@@ -268,6 +268,9 @@ Format: **entity** (type) \u2014 what was done with it, its current state>
 ## Open Questions / TODO
 <Anything unresolved, blocked, or explicitly deferred>
 
+## Next Steps
+<The single concrete next action to resume with, as one imperative line (e.g. "Wire the resume-brief Next Steps fallback and run the tests"). If the session reached a clean stopping point with nothing pending, write exactly: none>
+
 IMPORTANT: Be exhaustive. Extract EVERY entity, decision, and fact.
 PRIVACY: Never include absolute filesystem paths in the summary.
 LENGTH LIMIT: Keep the total summary under 4000 characters.`;

package/hermes/bundle/capture.js

@@ -1842,6 +1842,9 @@ Format: **entity** (type) \u2014 what was done with it, its current state>
 ## Open Questions / TODO
 <Anything unresolved, blocked, or explicitly deferred>
 
+## Next Steps
+<The single concrete next action to resume with, as one imperative line (e.g. "Wire the resume-brief Next Steps fallback and run the tests"). If the session reached a clean stopping point with nothing pending, write exactly: none>
+
 IMPORTANT: Be exhaustive. Extract EVERY entity, decision, and fact.
 PRIVACY: Never include absolute filesystem paths in the summary.
 LENGTH LIMIT: Keep the total summary under 4000 characters.`;

package/hermes/bundle/session-end.js

@@ -266,6 +266,9 @@ Format: **entity** (type) \u2014 what was done with it, its current state>
 ## Open Questions / TODO
 <Anything unresolved, blocked, or explicitly deferred>
 
+## Next Steps
+<The single concrete next action to resume with, as one imperative line (e.g. "Wire the resume-brief Next Steps fallback and run the tests"). If the session reached a clean stopping point with nothing pending, write exactly: none>
+
 IMPORTANT: Be exhaustive. Extract EVERY entity, decision, and fact.
 PRIVACY: Never include absolute filesystem paths in the summary.
 LENGTH LIMIT: Keep the total summary under 4000 characters.`;

package/openclaw/dist/index.js

@@ -1799,7 +1799,7 @@ function extractLatestVersion(body) {
   return typeof v === "string" && v.length > 0 ? v : null;
 }
 function getInstalledVersion() {
-  return "0.7.67".length > 0 ? "0.7.67" : null;
+  return "0.7.69".length > 0 ? "0.7.69" : null;
 }
 function isNewer(latest, current) {
   const parse = (v) => v.replace(/-.*$/, "").split(".").map(Number);

package/openclaw/openclaw.plugin.json

@@ -54,5 +54,5 @@
       }
     }
   },
-  "version": "0.7.67"
+  "version": "0.7.69"
 }

package/openclaw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hivemind",
-  "version": "0.7.67",
+  "version": "0.7.69",
   "type": "module",
   "description": "Hivemind — cloud-backed persistent shared memory for AI agents, powered by DeepLake",
   "license": "Apache-2.0",

package/openclaw/skills/hivemind-goals/SKILL.md

@@ -23,6 +23,31 @@ OpenClaw exposes purpose-built tools for goals + KPIs. Use them directly — do
 3. ONLY if the user asks for KPIs: `hivemind_kpi_add` once per KPI with `goal_id` + `kpi_id` (short slug like `k-prs`) + `target` (positive int) + `unit`.
 4. Confirm to the user with the goal_id and that the goal is team-visible.
 
+## Capture a task for later (with resumable context)
+
+When the user **parks a tangential task** mid-session — "save this for later", "remind me to …", "don't let me forget …", "let's do X later" — store enough **context to resume cold** later, not just a one-liner. Put the full package in the `text` of `hivemind_goal_add`:
+
+```
+hivemind_goal_add({ text:
+  "Add rate-limiting to the webhook handler\n\n" +
+  "Start here: add a per-IP token bucket on the handler entry path\n" +
+  "Files: src/webhook/handler.ts:120-160, src/webhook/limits.ts\n" +
+  "Branch: feat/webhook-hardening\n" +
+  "Run: pnpm test webhook\n" +
+  "Why: bursty clients hammer the endpoint; defer until retry-backoff lands" })
+```
+
+Line 1 is the label. Fill `Start here / Files / Branch / Run / Why` from the conversation; `Start here:` (the concrete first action) matters most. (OpenClaw's `hivemind_goal_add` has no provenance flag, so the row is tagged `manual` — that's fine; the context is what matters.)
+
+## Resume a parked task (automatic context transfer)
+
+When the user says "let's work on that task / goal" or "pick up the `<X>` task":
+
+1. `hivemind_search({ query: "<topic>" })` or `hivemind_index({})` to locate the parked goal, then `hivemind_read({ path: "memory/goal/<owner>/opened/<goal_id>.md" })` to pull the **full** context package back.
+2. Read it as your working context and begin from `Start here:` using the `Files` / `Branch` / `Run` lines — continue as if the context was never lost.
+
+(Status-move tools aren't exposed on OpenClaw, so leave the goal where it is and just resume the work.)
+
 ## What NOT to do
 
 - Do NOT write files anywhere under `~/.deeplake/memory/`. OpenClaw's runtime does not route filesystem writes to the Deeplake tables — only the `hivemind_*` tools above do.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeplake/hivemind",
-  "version": "0.7.67",
+  "version": "0.7.69",
   "description": "Cloud-backed persistent shared memory for AI agents powered by Deeplake",
   "type": "module",
   "repository": {