@onebrain-ai/cli 2.2.0 → 2.2.2

package/README.md

@@ -103,7 +103,7 @@ Obsidian becomes your dispatch hub for everything you do:
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="assets/diagrams/vault-hub-dark.svg">
-    <img alt="Obsidian as command center — eight spokes radiate from the vault to CLI/repo, website, cloud infra, social media, office docs, project notes, research, and MCP server" src="assets/diagrams/vault-hub-light.svg" width="640">
+    <img alt="Obsidian as command center — eight spokes radiate from the vault to CLI/repo, website, cloud infra, social media, office docs, project notes, research, and MCP server" src="assets/diagrams/vault-hub-light.svg" width="460">
   </picture>
 </p>
 
@@ -118,7 +118,7 @@ OneBrain runs as a tight 3-step loop. Each cycle, both sides sharpen.
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="assets/diagrams/coevo-loop-dark.svg">
-    <img alt="Co-Evolution loop — three nodes (01 CAPTURE at top, 02 EVOLVE at bottom-right, 03 WRAPUP at bottom-left) connected by curved arrows flowing clockwise" src="assets/diagrams/coevo-loop-light.svg" width="540">
+    <img alt="Co-Evolution loop — three nodes (01 CAPTURE at top, 02 EVOLVE at bottom-right, 03 WRAPUP at bottom-left) connected by curved arrows flowing clockwise" src="assets/diagrams/coevo-loop-light.svg" width="350">
   </picture>
 </p>
 

package/dist/onebrain

@@ -8909,7 +8909,7 @@ async function loadVaultConfig(vaultRoot) {
   const file = Bun.file(vaultYmlPath);
   const exists = await file.exists();
   if (!exists) {
-    throw new Error(`vault.yml not found at ${vaultYmlPath}. Run onebrain init to set up this vault.`);
+    throw new Error(`${VAULT_YML_NOT_FOUND_PREFIX}${vaultYmlPath}. Run onebrain init to set up this vault.`);
   }
   const text = await file.text();
   const parsed = import_yaml.parse(text) ?? {};
@@ -8952,7 +8952,7 @@ async function loadVaultConfig(vaultRoot) {
   }
   return config;
 }
-var import_yaml, DEFAULT_FOLDERS, DEFAULT_CHECKPOINT;
+var import_yaml, DEFAULT_FOLDERS, DEFAULT_CHECKPOINT, VAULT_YML_NOT_FOUND_PREFIX = "vault.yml not found at ";
 var init_parser = __esm(() => {
   import_yaml = __toESM(require_dist(), 1);
   DEFAULT_FOLDERS = {
@@ -9545,7 +9545,9 @@ __export(exports_lib, {
   checkOrphanCheckpoints: () => checkOrphanCheckpoints,
   checkFolders: () => checkFolders,
   checkClaudeSettings: () => checkClaudeSettings,
-  atomicWrite: () => atomicWrite
+  atomicWrite: () => atomicWrite,
+  VAULT_YML_NOT_FOUND_PREFIX: () => VAULT_YML_NOT_FOUND_PREFIX,
+  DEFAULT_CHECKPOINT: () => DEFAULT_CHECKPOINT
 });
 var init_lib = __esm(() => {
   init_parser();
@@ -9558,7 +9560,7 @@ var init_lib = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@onebrain-ai/cli",
-    version: "2.2.0",
+    version: "2.2.2",
     description: "CLI for OneBrain \u2014 personal AI OS for Obsidian with persistent memory, 24+ skills, and Claude Code integration",
     keywords: [
       "onebrain",
@@ -10989,7 +10991,7 @@ var import_picocolors5 = __toESM(require_picocolors(), 1);
 var import_picocolors = __toESM(require_picocolors(), 1);
 function resolveBinaryVersion() {
   if (true)
-    return "2.2.0";
+    return "2.2.2";
   try {
     const pkg = require_package();
     return pkg.version ?? "dev";
@@ -11481,7 +11483,8 @@ async function runDoctor(opts = {}) {
       agent: "05-agent",
       archive: "06-archive",
       logs: "07-logs"
-    }
+    },
+    checkpoint: { ...DEFAULT_CHECKPOINT }
   };
   const sp1 = createStep("\uD83D\uDCCB", "vault.yml");
   const vaultYmlResult = await checkVaultYmlFn(vaultDir);
@@ -12408,9 +12411,7 @@ function loadVaultSettings(vaultRoot) {
   }
 }
 function maxCheckpointNnSync(vaultRoot, date, token, logsFolder) {
-  const yyyy = date.slice(0, 4);
-  const mm = date.slice(5, 7);
-  const dir = join7(vaultRoot, logsFolder, yyyy, mm);
+  const dir = join7(vaultRoot, logsFolder, "checkpoint");
   const prefix = `${date}-${token}-checkpoint-`;
   try {
     let max = 0;
@@ -12525,14 +12526,15 @@ async function runBackfillRecapped(logsFolder, cutoffDate) {
   const today = new Date().toISOString().slice(0, 10);
   let backfilled = 0;
   let skipped = 0;
+  const sessionRoot = join8(logsFolder, "session");
   let yearDirs = [];
   try {
-    yearDirs = await readdir3(logsFolder);
+    yearDirs = await readdir3(sessionRoot);
   } catch {
     return { backfilled: 0, skipped: 0 };
   }
   for (const yearDir of yearDirs) {
-    const yearPath = join8(logsFolder, yearDir);
+    const yearPath = join8(sessionRoot, yearDir);
     let monthDirs = [];
     try {
       monthDirs = await readdir3(yearPath);
@@ -12603,9 +12605,12 @@ async function migrateCommand(migrationName, cutoffDate, vaultDir) {
 }
 
 // src/commands/internal/orphan-scan.ts
+init_parser();
 var import_yaml6 = __toESM(require_dist(), 1);
-import { readFile as readFile5, readdir as readdir4 } from "fs/promises";
+import { readFile as readFile5, readdir as readdir4, stat as stat6 } from "fs/promises";
 import { join as join9 } from "path";
+var MIN_GUARD_MINUTES = 60;
+var DEFAULT_ACTIVE_SESSION_GUARD_MS = 60 * 60 * 1000;
 function parseFrontmatter(rawText) {
   const text = rawText.replace(/\r\n/g, `
 `);
@@ -12623,14 +12628,6 @@ function parseFrontmatter(rawText) {
     return null;
   }
 }
-function getMonthParts(now = new Date) {
-  const thisYear = String(now.getFullYear());
-  const thisMonth = String(now.getMonth() + 1).padStart(2, "0");
-  const prevDate = new Date(now.getFullYear(), now.getMonth() - 1, 1);
-  const prevYear = String(prevDate.getFullYear());
-  const prevMonth = String(prevDate.getMonth() + 1).padStart(2, "0");
-  return { thisYear, thisMonth, prevYear, prevMonth };
-}
 async function listMdFiles2(dir) {
   try {
     const entries = await readdir4(dir);
@@ -12639,6 +12636,61 @@ async function listMdFiles2(dir) {
     return [];
   }
 }
+async function getActiveSessionGuardMs(vaultRoot) {
+  try {
+    const config = await loadVaultConfig(vaultRoot);
+    const cpMinutes = config.checkpoint.minutes;
+    if (typeof cpMinutes !== "number" || !Number.isFinite(cpMinutes) || cpMinutes <= 0) {
+      return DEFAULT_ACTIVE_SESSION_GUARD_MS;
+    }
+    const minutes = Math.max(MIN_GUARD_MINUTES, 2 * cpMinutes);
+    return minutes * 60 * 1000;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    const isExpectedAbsence = msg.startsWith(VAULT_YML_NOT_FOUND_PREFIX);
+    if (!isExpectedAbsence) {
+      try {
+        process.stderr.write(`onebrain orphan-scan: vault.yml unreadable, using ${MIN_GUARD_MINUTES}-min Active-Session Guard default (${msg})
+`);
+      } catch {}
+    }
+    return DEFAULT_ACTIVE_SESSION_GUARD_MS;
+  }
+}
+async function getMtimeMs(path) {
+  try {
+    const s = await stat6(path);
+    if (typeof s.mtimeMs !== "number" || !Number.isFinite(s.mtimeMs))
+      return null;
+    return s.mtimeMs;
+  } catch {
+    return null;
+  }
+}
+async function getNewestMtimeMs(filePaths) {
+  if (filePaths.length === 0)
+    return null;
+  let newest = Number.NEGATIVE_INFINITY;
+  for (const p2 of filePaths) {
+    const m3 = await getMtimeMs(p2);
+    if (m3 === null)
+      return null;
+    if (m3 > newest)
+      newest = m3;
+  }
+  return Number.isFinite(newest) ? newest : null;
+}
+async function isGroupActiveOrAmbiguous(filePaths, nowMs, guardMs) {
+  if (!Number.isFinite(guardMs) || guardMs <= 0)
+    return true;
+  const newest = await getNewestMtimeMs(filePaths);
+  if (newest === null)
+    return true;
+  const ageMs = nowMs - newest;
+  if (ageMs < 0)
+    return true;
+  return ageMs < guardMs;
+}
 async function hasManualSessionLog(monthDir, date) {
   const files = await listMdFiles2(monthDir);
   const sessionLogs = files.filter((f2) => f2.startsWith(date) && f2.includes("-session-") && f2.endsWith(".md"));
@@ -12653,10 +12705,22 @@ async function hasManualSessionLog(monthDir, date) {
   }
   return false;
 }
-async function scanMonthDir(monthDir, currentToken, today, seenTokens) {
-  const files = await listMdFiles2(monthDir);
+async function collectCandidateGroups(checkpointDir, sessionDir, currentToken, today) {
+  const groups = new Map;
+  const files = await listMdFiles2(checkpointDir);
   const checkpoints = files.filter((f2) => f2.includes("-checkpoint-") && f2.endsWith(".md"));
-  let count = 0;
+  const manualLogCache = new Map;
+  async function dateHasManualLog(date) {
+    const cached = manualLogCache.get(date);
+    if (cached !== undefined)
+      return cached;
+    const year = date.slice(0, 4);
+    const month = date.slice(5, 7);
+    const sessionMonthDir = join9(sessionDir, year, month);
+    const result = await hasManualSessionLog(sessionMonthDir, date);
+    manualLogCache.set(date, result);
+    return result;
+  }
   for (const fname of checkpoints) {
     const dateMatch = fname.match(/^(\d{4}-\d{2}-\d{2})-/);
     if (!dateMatch)
@@ -12673,32 +12737,37 @@ async function scanMonthDir(monthDir, currentToken, today, seenTokens) {
       continue;
     if (ftoken === currentToken)
       continue;
-    if (seenTokens.has(ftoken))
-      continue;
-    if (await hasManualSessionLog(monthDir, fdate))
+    if (await dateHasManualLog(fdate))
       continue;
-    seenTokens.add(ftoken);
-    count++;
+    const fpath = join9(checkpointDir, fname);
+    const existing = groups.get(ftoken);
+    if (existing)
+      existing.push(fpath);
+    else
+      groups.set(ftoken, [fpath]);
   }
-  return count;
+  return groups;
 }
-async function runOrphanScan(logsFolder, sessionToken, now) {
+async function runOrphanScan(logsFolder, sessionToken, now, vaultRoot) {
+  if (!vaultRoot) {
+    throw new Error("runOrphanScan: vaultRoot is required and must be a non-empty path");
+  }
   const today = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
-  const { thisYear, thisMonth, prevYear, prevMonth } = getMonthParts(now);
-  const monthDirs = [
-    { year: thisYear, month: thisMonth },
-    { year: prevYear, month: prevMonth }
-  ];
-  const seenTokens = new Set;
+  const checkpointDir = join9(logsFolder, "checkpoint");
+  const sessionDir = join9(logsFolder, "session");
+  const allGroups = await collectCandidateGroups(checkpointDir, sessionDir, sessionToken, today);
+  const guardMs = await getActiveSessionGuardMs(vaultRoot);
+  const nowMs = now.getTime();
   let totalOrphans = 0;
-  for (const { year, month } of monthDirs) {
-    const monthDir = join9(logsFolder, year, month);
-    totalOrphans += await scanMonthDir(monthDir, sessionToken, today, seenTokens);
+  for (const [, files] of allGroups) {
+    if (await isGroupActiveOrAmbiguous(files, nowMs, guardMs))
+      continue;
+    totalOrphans++;
   }
   return { orphan_count: totalOrphans };
 }
 async function orphanScanCommand(logsFolder, sessionToken) {
-  const result = await runOrphanScan(logsFolder, sessionToken, new Date);
+  const result = await runOrphanScan(logsFolder, sessionToken, new Date, process.cwd());
   process.stdout.write(`${JSON.stringify(result)}
 `);
 }
@@ -13220,8 +13289,8 @@ function patchUtf8(stream) {
 }
 
 // src/index.ts
-var VERSION = "2.2.0";
-var RELEASE_DATE = "2026-05-07";
+var VERSION = "2.2.2";
+var RELEASE_DATE = "2026-05-10";
 patchUtf8(process.stdout);
 patchUtf8(process.stderr);
 var VERSION_STRING = `OneBrain v${VERSION} \u2014 released ${RELEASE_DATE}`;

package/package.json

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