@onebrain-ai/cli 2.3.1 → 2.3.2

package/README.md

@@ -84,7 +84,7 @@ A great harness already knows how to talk to an LLM, edit files, and run shell c
 | | What OneBrain adds | Why it matters |
 |---|---|---|
 | 🧠 | **Memory** — Identity, preferences, decisions, project state — promoted across four tiers as it earns trust | The harness alone starts every session from zero. OneBrain doesn't. |
-| ⚡ | **Skills** — 29+ vault-aware verbs (`/braindump`, `/research`, `/distill`, `/learn`, `/wrapup`, …) | Pre-built workflows the harness would otherwise need you to script every time. |
+| ⚡ | **Skills** — 31+ vault-aware verbs (`/braindump`, `/research`, `/distill`, `/learn`, `/wrapup`, …) | Pre-built workflows the harness would otherwise need you to script every time. |
 | 🎯 | **Calibration** — Every correction, every preference, every learned habit tunes the agent to *you* | The longer you use it, the sharper it gets — your vault is the training data. |
 | 🔀 | **Continuity** — Context lives in the vault, not the harness | Switch from Claude Code to Gemini CLI to Codex. Same memory. Same skills. Same agent. |
 
@@ -196,6 +196,8 @@ OneBrain has automatic behaviors that run without you doing anything:
 
 **`/wrapup` is manual only.** Run it yourself when you want a visible, full session summary with output shown.
 
+**Pausing long work across sessions.** For multi-day tasks that don't fit one session, run `/pause` to save a snapshot, then `/resume` in a future session to pick up seamlessly. Pause snapshots accumulate per-thread in `07-logs/pause/`; the next `/wrapup` consolidates them into one session log. This fills the gap between auto-checkpoint (involuntary) and `/wrapup` (terminal).
+
 **The practical result:** Just say "bye" and everything is saved. If the session ends unexpectedly, you lose at most 15 messages — the last checkpoint recovers the rest.
 
 > Auto Checkpoint runs on Claude Code (`Stop` hook) and Gemini CLI (`AfterAgent` hook), and uses the `onebrain` CLI binary. Install with `npm install -g @onebrain-ai/cli`. Auto Session Summary works with any agent that follows INSTRUCTIONS.md.
@@ -210,7 +212,7 @@ OneBrain doesn't just store markdown. Every feature exists to make you and the a
 |---|---|---|
 | 🧠 | **Persistent Memory** | Remembers your name, goals, preferences, and decisions across every session |
 | 🖥️ | **Personal AI OS** | Full local stack: Claude Code + Obsidian + tmux + Telegram — no cloud infra needed |
-| ⚡ | **29+ Skills** | Braindump, research, consolidate, bookmark, import files, daily briefing, and more |
+| ⚡ | **31+ Skills** | Braindump, research, consolidate, bookmark, import files, daily briefing, and more |
 | 📂 | **Vault-native Markdown** | Plain Markdown, no lock-in. Your data stays yours forever |
 | 🔀 | **Multi-Harness OS** | Switch between Claude Code, Gemini CLI, Codex, Qwen, or BYO LLM — context never breaks. [See architecture ↑](#the-harness-os-architecture) |
 | 🔌 | **Zero Config** | Clone, open in Obsidian, run `/onboarding`. Ready in under 2 minutes |
@@ -340,7 +342,9 @@ Same vault. Same skills. Same memory. The LLM swaps; OneBrain doesn't notice.
 
 <a id="commands"></a>
 
-## 📋 29+ Commands
+<!-- NEW-BADGE-CLEANUP: remove the green NEW shields.io badges from /search, /pause, /resume, /schedule-* on or after 2026-05-19 -->
+
+## 📋 31+ Commands
 
 Skills are organized by workflow phase. **Gemini CLI users:** prepend the `onebrain:` namespace, e.g. `/onebrain:braindump` instead of `/braindump` (avoids collisions with Gemini built-in commands like `/help` and `/tasks`).
 
@@ -373,7 +377,7 @@ Skills are organized by workflow phase. **Gemini CLI users:** prepend the `onebr
 
 | Command | What it does |
 |---------|-------------|
-| `/search` | General vault retrieval — answers what + why questions across MEMORY, sessions, plans, decisions logs, notes |
+| `/search` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | General vault retrieval — answers what + why questions across MEMORY, sessions, plans, decisions logs, notes |
 | `/tasks` | Live task dashboard in Obsidian — creates/updates `TASKS.md` with always-current query sections |
 | `/moc` | Vault portal in Obsidian — creates/updates `MOC.md` with projects, areas, knowledge, tasks, and pinned links |
 | `/memory-review` | Interactive review of memory files — keep, update, deprecate, or delete entries |
@@ -389,10 +393,12 @@ Skills are organized by workflow phase. **Gemini CLI users:** prepend the `onebr
 | `/qmd` | Set up fast vault search index — enables semantic search across all notes |
 | `/help` | List all available commands with descriptions |
 | `/wrapup` | Wrap up session — merges any auto-checkpoints and saves full summary to session log |
-| `/schedule-add` | Interactive wizard for adding a recurring scheduled skill |
-| `/schedule-once` | One-shot wizard: schedule a skill to run once at a specific datetime |
-| `/schedule-list` | Show all scheduled entries |
-| `/schedule-remove` | Remove a scheduled entry |
+| `/pause` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Save a snapshot of long-running work mid-flight so a future session can `/resume` (does NOT end the session or clear context) |
+| `/resume` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Load the latest snapshot of an active pause thread and pick up seamlessly in a fresh session |
+| `/schedule-add` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Interactive wizard for adding a recurring scheduled skill |
+| `/schedule-once` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | One-shot wizard: schedule a skill to run once at a specific datetime |
+| `/schedule-list` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Show all scheduled entries |
+| `/schedule-remove` ![NEW](https://img.shields.io/badge/NEW-success?style=flat-square) | Remove a scheduled entry |
 
 <details>
 <summary><strong>📁 Vault Structure</strong></summary>
@@ -544,6 +550,16 @@ schedule:
 
 This matches the same shape Claude Code uses for `hooks` in `settings.json` — direct binary invocation with positional argv. No wrapper skill needed.
 
+### Quick start — preset bundles
+
+Don't want to hand-craft cron entries? OneBrain ships three preset tiers. New vaults are prompted during `/onboarding`; existing vaults can trigger the selector by running `/schedule-add` when the `schedule:` block is empty.
+
+- **Minimal** — `/daily` briefing only
+- **Essentials (default)** — `/daily` + `/weekly` Friday + `/recap` Sunday
+- **Maintenance Plus** — Essentials + `/doctor` monthly + `/tasks` daily + `onebrain qmd-reindex` Sunday (mixes skill + command modes)
+
+Canonical tier definitions live at `.claude/plugins/onebrain/skills/_shared/schedule-presets.md`.
+
 CLI flags:
 
 | Flag | Purpose |

package/dist/onebrain

@@ -9366,9 +9366,33 @@ async function checkClaudeSettings(vaultRoot) {
   }
   return { check: "claude-settings", status: "ok", message: "ok" };
 }
-function hookPresent(settings, event, cmdSubstring) {
+function effectiveCommand(h) {
+  const parts = [];
+  if (typeof h.command === "string" && h.command.length > 0)
+    parts.push(h.command);
+  if (Array.isArray(h.args)) {
+    for (const a of h.args)
+      if (typeof a === "string" && a.length > 0)
+        parts.push(a);
+  }
+  return parts.join(" ");
+}
+function detectHookForm(settings, event, cmdSubstring) {
+  let sawLegacy = false;
   const groups = settings.hooks?.[event] ?? [];
-  return groups.some((g) => g.hooks?.some((h) => (h.command ?? "").includes(cmdSubstring)));
+  for (const g of groups) {
+    for (const h of g.hooks ?? []) {
+      if (!effectiveCommand(h).includes(cmdSubstring))
+        continue;
+      const isCanonical = h.command === CANONICAL_HOOK_COMMAND && (h.args?.length ?? 0) > 0;
+      if (isCanonical)
+        return "exec";
+      sawLegacy = true;
+    }
+  }
+  if (sawLegacy)
+    return "legacy";
+  return "absent";
 }
 async function checkSettingsHooks(vaultRoot, config) {
   const settingsPath = join2(vaultRoot, ".claude", "settings.json");
@@ -9396,15 +9420,21 @@ async function checkSettingsHooks(vaultRoot, config) {
   const confirmedHooks = [];
   let permissionOk = false;
   for (const { event, cmdSubstring } of REQUIRED_HOOKS) {
-    if (!hookPresent(settings, event, cmdSubstring)) {
+    const form = detectHookForm(settings, event, cmdSubstring);
+    if (form === "absent") {
       warnings.push(`${event} hook missing`);
+    } else if (form === "legacy") {
+      warnings.push(`${event} hook in legacy shell form \u2014 --fix will migrate to exec form`);
     } else {
       confirmedHooks.push(`${event} \u2713`);
     }
   }
   if (config.qmd_collection) {
-    if (!hookPresent(settings, "PostToolUse", QMD_HOOK_SUBSTRING)) {
+    const form = detectHookForm(settings, "PostToolUse", QMD_HOOK_SUBSTRING);
+    if (form === "absent") {
       warnings.push("PostToolUse (qmd) hook missing");
+    } else if (form === "legacy") {
+      warnings.push("PostToolUse (qmd) hook in legacy shell form \u2014 --fix will migrate to exec form");
     } else {
       confirmedHooks.push("PostToolUse \u2713");
     }
@@ -9413,7 +9443,7 @@ async function checkSettingsHooks(vaultRoot, config) {
     const groups = settings.hooks?.[event] ?? [];
     for (const g of groups) {
       for (const h of g.hooks ?? []) {
-        const cmd = h.command ?? "";
+        const cmd = effectiveCommand(h);
         if (!ALLOWED_HOOK_EVENTS.has(event) && cmd.includes(ONEBRAIN_COMMAND_SUBSTRING)) {
           warnings.push(`stale ${event} hook found (onebrain CLI only registers Stop + PostToolUse)`);
         }
@@ -9452,7 +9482,7 @@ async function checkSettingsHooks(vaultRoot, config) {
     ...okDetails.length > 0 ? { details: okDetails } : {}
   };
 }
-var import_yaml2, STANDARD_FOLDER_KEYS, REQUIRED_PLUGIN_FILES, REQUIRED_PLUGIN_DIRS, STALE_BASH_FILES, REQUIRED_VAULT_YML_KEYS, SOFT_REQUIRED_VAULT_YML_KEYS, REQUIRED_FOLDER_KEYS, STALE_MARKETPLACE_REPO = "kengio/onebrain", CANONICAL_MARKETPLACE_REPO = "onebrain-ai/onebrain", REQUIRED_HOOKS, ALLOWED_HOOK_EVENTS, QMD_HOOK_SUBSTRING = "onebrain qmd-reindex", ONEBRAIN_COMMAND_SUBSTRING = "onebrain", REQUIRED_PERMISSION = "Bash(onebrain *)", STALE_HOOK_SUBSTRINGS;
+var import_yaml2, STANDARD_FOLDER_KEYS, REQUIRED_PLUGIN_FILES, REQUIRED_PLUGIN_DIRS, STALE_BASH_FILES, REQUIRED_VAULT_YML_KEYS, SOFT_REQUIRED_VAULT_YML_KEYS, REQUIRED_FOLDER_KEYS, STALE_MARKETPLACE_REPO = "kengio/onebrain", CANONICAL_MARKETPLACE_REPO = "onebrain-ai/onebrain", REQUIRED_HOOKS, ALLOWED_HOOK_EVENTS, QMD_HOOK_SUBSTRING = "onebrain qmd-reindex", ONEBRAIN_COMMAND_SUBSTRING = "onebrain", REQUIRED_PERMISSION = "Bash(onebrain *)", STALE_HOOK_SUBSTRINGS, CANONICAL_HOOK_COMMAND = "onebrain";
 var init_validator = __esm(() => {
   import_yaml2 = __toESM(require_dist(), 1);
   STANDARD_FOLDER_KEYS = [
@@ -9560,7 +9590,7 @@ var init_lib = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@onebrain-ai/cli",
-    version: "2.3.1",
+    version: "2.3.2",
     description: "CLI for OneBrain \u2014 personal AI OS for Obsidian with persistent memory, 24+ skills, and Claude Code integration",
     keywords: [
       "onebrain",
@@ -11048,7 +11078,7 @@ var import_picocolors5 = __toESM(require_picocolors(), 1);
 var import_picocolors = __toESM(require_picocolors(), 1);
 function resolveBinaryVersion() {
   if (true)
-    return "2.3.1";
+    return "2.3.2";
   try {
     const pkg = require_package();
     return pkg.version ?? "dev";
@@ -13728,7 +13758,7 @@ function patchUtf8(stream) {
 }
 
 // src/index.ts
-var VERSION = "2.3.1";
+var VERSION = "2.3.2";
 var RELEASE_DATE = "2026-05-12";
 patchUtf8(process.stdout);
 patchUtf8(process.stderr);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onebrain-ai/cli",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "description": "CLI for OneBrain — personal AI OS for Obsidian with persistent memory, 24+ skills, and Claude Code integration",
   "keywords": [
     "onebrain",