backpass 0.1.9 → 0.1.10

package/README.md

@@ -84,7 +84,7 @@ backpass reads the local transcript stores of seven harnesses directly. No API,
 | -------------- | ---------------------------------------------- | --------------------------------------------------- |
 | **claude**     | `~/.claude/projects/<munged-cwd>/<uuid>.jsonl` | per-line `cwd`                                      |
 | **codex**      | `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl` | `cwd` + recorded `git.repository_url`               |
-| **pi**         | `~/.pi/agent/sessions/<escaped-cwd>/*.jsonl`   | session-header `cwd`                                |
+| **pi**         | standalone and BB-managed Pi JSONL stores      | session-header `cwd`                                |
 | **opencode**   | `~/.local/share/opencode/opencode.db` (sqlite) | `session.directory`                                 |
 | **grok**       | `~/.grok/sessions/<encoded-cwd>/<uuid>/`       | `summary.json` `cwd` + `git_remotes`                |
 | **cursor CLI** | `~/.cursor/chats/<md5(cwd)>/<uuid>/`           | `meta.json` `cwd`                                   |
@@ -95,6 +95,12 @@ relocated config dir does not hide its sessions. The variable is read from backp
 environment: if you reach that profile through an alias that only prefixes `claude`, set it
 for the backpass run too (`CLAUDE_CONFIG_DIR=~/.claude-work backpass`, or export it).
 
+Pi collection covers standalone sessions under `~/.pi/agent/sessions/` and BB-managed Pi
+sessions under `~/.bb/pi-bridge-sessions/`. It also honors `PI_CODING_AGENT_DIR`,
+`PI_CODING_AGENT_SESSION_DIR`, `BB_DATA_DIR`, and `BB_PI_BRIDGE_SESSION_DIR` when they are
+set in backpass's environment. When roots overlap, backpass scans every applicable layout
+and reads each JSONL file once.
+
 Hermes collection includes CLI and ACP sessions only. Gateway, cron, and WhatsApp sessions
 are excluded because their recorded cwd belongs to the shared gateway process, not a project.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backpass",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "packageManager": "pnpm@11.5.0",
   "description": "Gradient descent for your agent memory - analyzes past agent session transcripts and proposes evidence-backed edits to AGENTS.md / CLAUDE.md",
   "type": "module",

package/src/discovery/adapters/pi.js

@@ -1,3 +1,4 @@
+import fs from "node:fs";
 import path from "node:path";
 
 import {
@@ -13,7 +14,9 @@ import {
 } from "./shared.js";
 
 /**
- * pi: ~/.pi/agent/sessions/<escaped-cwd>/<ISO-ts>_<uuid>.jsonl
+ * Pi writes standalone sessions under
+ * `~/.pi/agent/sessions/<escaped-cwd>/<ISO-ts>_<uuid>.jsonl`. BB's Pi bridge writes the
+ * same JSONL shape directly under `<bb-data-dir>/pi-bridge-sessions/`.
  *
  * Line 1 is `{type:"session", cwd, id}`. Entries form a parent/child tree but arrive in
  * order, so a linear read is faithful. `model_change` / `thinking_level_change` records
@@ -26,13 +29,69 @@ export function storeRoot() {
   return home(".pi", "agent", "sessions");
 }
 
+function expandEnvPath(value) {
+  const trimmed = value?.trim();
+  if (!trimmed) return null;
+  if (trimmed === "~") return home();
+  if (trimmed.startsWith("~/")) return path.join(home(), trimmed.slice(2));
+  return path.resolve(trimmed);
+}
+
+function realpathOrResolve(value) {
+  try {
+    return fs.realpathSync(value);
+  } catch {
+    return path.resolve(value);
+  }
+}
+
+function storeSpecs() {
+  const specs = [
+    { path: storeRoot(), direct: false, nested: true },
+    { path: home(".bb", "pi-bridge-sessions"), direct: true, nested: false },
+  ];
+  const piAgentDir = expandEnvPath(process.env.PI_CODING_AGENT_DIR);
+  if (piAgentDir) specs.push({ path: path.join(piAgentDir, "sessions"), direct: false, nested: true });
+  const piSessionDir = expandEnvPath(process.env.PI_CODING_AGENT_SESSION_DIR);
+  if (piSessionDir) specs.push({ path: piSessionDir, direct: true, nested: false });
+  const bbDataDir = expandEnvPath(process.env.BB_DATA_DIR);
+  if (bbDataDir) specs.push({ path: path.join(bbDataDir, "pi-bridge-sessions"), direct: true, nested: false });
+  const bridgeDir = expandEnvPath(process.env.BB_PI_BRIDGE_SESSION_DIR);
+  if (bridgeDir) specs.push({ path: bridgeDir, direct: true, nested: false });
+
+  const unique = new Map();
+  for (const spec of specs) {
+    const key = realpathOrResolve(spec.path);
+    const existing = unique.get(key);
+    if (existing) {
+      existing.direct ||= spec.direct;
+      existing.nested ||= spec.nested;
+    } else {
+      unique.set(key, spec);
+    }
+  }
+  return [...unique.values()];
+}
+
+export function storeRoots() {
+  return storeSpecs().map((spec) => spec.path);
+}
+
 export function enumerate() {
   const out = [];
-  for (const dir of listDirs(storeRoot())) {
-    for (const file of listFiles(dir, ".jsonl")) {
+  const seen = new Set();
+  for (const spec of storeSpecs()) {
+    const files = [
+      ...(spec.direct ? listFiles(spec.path, ".jsonl") : []),
+      ...(spec.nested ? listDirs(spec.path).flatMap((dir) => listFiles(dir, ".jsonl")) : []),
+    ];
+    for (const file of files) {
+      const key = realpathOrResolve(file);
+      if (seen.has(key)) continue;
+      seen.add(key);
       const stat = statOrNull(file);
       if (!stat) continue;
-      out.push({ key: file, path: file, mtimeMs: stat.mtimeMs, bytes: stat.size });
+      out.push({ key, path: file, mtimeMs: stat.mtimeMs, bytes: stat.size });
     }
   }
   return out;