@bunshin-cc/bunshin 0.3.3 → 0.4.1

package/dist/bin.js

@@ -2674,6 +2674,17 @@ ${d.text.replace(/\n*$/, "\n")}`),
   ];
   return parts.join("\n");
 }
+function removeBlock(file) {
+  const text2 = readText(file);
+  if (text2 === null) return false;
+  const start = text2.indexOf(BLOCK_BEGIN);
+  const end = text2.indexOf(BLOCK_END);
+  if (start < 0 || end < start) return false;
+  const rest = (text2.slice(0, start).replace(/\s*$/, "") + "\n" + text2.slice(end + BLOCK_END.length).replace(/^\s*/, "")).trim();
+  if (rest) writeTextAtomic(file, rest + "\n");
+  else fs5.unlinkSync(file);
+  return true;
+}
 function writeBlock(file, block2) {
   const text2 = readText(file) ?? "";
   const start = text2.indexOf(BLOCK_BEGIN);
@@ -2984,9 +2995,9 @@ function deployLocked(v2, config, ctx, bundle, opts, p, harnesses, now) {
       }
     }
   }
-  const blockDocs = plan.instructions.map((s) => ({ id: s.id, version: s.version, text: next[s.id]?.pending ? readBlock(p.claudeMd)?.get(s.id) ?? s.body : s.body }));
+  const blockDocs = config.instructionsFile ? plan.instructions.map((s) => ({ id: s.id, version: s.version, text: next[s.id]?.pending ? readBlock(p.claudeMd)?.get(s.id) ?? s.body : s.body })) : [];
   if (harnesses.has("claude-code") && (blockDocs.length || readBlock(p.claudeMd))) {
-    if (writeBlock(p.claudeMd, renderBlock(blockDocs, ""))) report.written++;
+    if (blockDocs.length ? writeBlock(p.claudeMd, renderBlock(blockDocs, "")) : removeBlock(p.claudeMd)) report.written++;
   }
   if (harnesses.has("codex") && (blockDocs.length || plan.skills.length || readBlock(p.agentsMd))) {
     if (writeBlock(p.agentsMd, renderBlock(blockDocs, skillIndex(plan.skills, p)))) report.written++;
@@ -7127,8 +7138,8 @@ async function cmdImport2(store, args, cwd, out, err) {
     if (batches.length > 1) out(`  batch ${i + 1}/${batches.length}: ${last.versions.length} versions${last.skipped.length ? `, ${last.skipped.length} already imported` : ""}
 `);
   }
-  const lib = last?.versions.at(-1)?.version;
-  out(`Imported into the library: ${written} document revisions${lib ? `, now lib@${lib}` : ""}; ${last?.documents ?? 0} documents active in ${pack}.
+  const lib2 = last?.versions.at(-1)?.version;
+  out(`Imported into the library: ${written} document revisions${lib2 ? `, now lib@${lib2}` : ""}; ${last?.documents ?? 0} documents active in ${pack}.
 `);
   if (history) out("Old commit pins resolve with `bunshin library checkout --git <sha>`.\n");
   const propose = args.flags["propose-rewrites"];
@@ -7316,8 +7327,8 @@ function sinceCutoff(since) {
 }
 function parsePin(text2) {
   const t = text2.trim();
-  const lib = /lib@(\d+)/.exec(t) ?? /^(\d+)$/.exec(t);
-  if (lib) return { version: Number(lib[1]) };
+  const lib2 = /lib@(\d+)/.exec(t) ?? /^(\d+)$/.exec(t);
+  if (lib2) return { version: Number(lib2[1]) };
   const sha2 = /\b([0-9a-f]{7,40})\b/i.exec(t);
   return sha2 ? { git: sha2[1].toLowerCase() } : {};
 }
@@ -7826,6 +7837,94 @@ init_v22();
 init_transcript();
 init_api();
 init_deploy();
+
+// src/v2/live.ts
+init_api();
+var LIVE_REFRESH_MS = 5 * 6e4;
+var MAX_DIFF_LINES = 80;
+var instructionDocs = (bundle) => (bundle?.sections ?? []).filter((s) => s.delivery === "always" && s.status === "active");
+var skillDocs = (bundle) => (bundle?.sections ?? []).filter((s) => !!s.skill && s.status === "active");
+function baselineOf(bundle) {
+  return {
+    ...bundle?.libraryVersion !== void 0 ? { library: bundle.libraryVersion } : {},
+    skills: Object.fromEntries(skillDocs(bundle).map((s) => [s.id, { version: s.version, name: s.skill.name }])),
+    instructions: Object.fromEntries(instructionDocs(bundle).map((s) => [s.id, s.body]))
+  };
+}
+var lib = (v) => v === void 0 ? "the library" : `lib@${v}`;
+function renderInstructions(bundle) {
+  const docs = instructionDocs(bundle);
+  if (!docs.length) return "";
+  return [
+    `## Standing instructions (your organization, from Bunshin ${lib(bundle?.libraryVersion)})`,
+    "Follow these as you would CLAUDE.md. Bunshin re-delivers them after /clear and compaction, and tells you when they change.",
+    "",
+    ...docs.map((d) => d.body.trim())
+  ].join("\n");
+}
+function lineDiff(before, after, max = MAX_DIFF_LINES) {
+  const a = before.split("\n");
+  const b = after.split("\n");
+  if (a.length * b.length > 4e6) return [`(the text changed substantially; ${b.length} lines now)`];
+  const dp = Array.from({ length: a.length + 1 }, () => new Uint32Array(b.length + 1));
+  for (let i2 = a.length - 1; i2 >= 0; i2--) for (let j2 = b.length - 1; j2 >= 0; j2--) dp[i2][j2] = a[i2] === b[j2] ? dp[i2 + 1][j2 + 1] + 1 : Math.max(dp[i2 + 1][j2], dp[i2][j2 + 1]);
+  const out = [];
+  let i = 0;
+  let j = 0;
+  while (i < a.length || j < b.length) {
+    if (i < a.length && j < b.length && a[i] === b[j]) {
+      i++;
+      j++;
+    } else if (j < b.length && (i === a.length || dp[i][j + 1] >= dp[i + 1][j])) {
+      if (b[j].trim()) out.push(`+ ${b[j]}`);
+      j++;
+    } else {
+      if (a[i].trim()) out.push(`- ${a[i]}`);
+      i++;
+    }
+  }
+  return out.length > max ? [...out.slice(0, max), `\u2026 ${out.length - max} more changed lines`] : out;
+}
+function changesSince(base, bundle, skillPath) {
+  const next = baselineOf(bundle);
+  if (!bundle || next.library === base.library) return { text: "", next: base };
+  const lines = [];
+  const now = instructionDocs(bundle);
+  for (const d of now) {
+    const old = base.instructions[d.id];
+    if (old === d.body) continue;
+    if (old === void 0) {
+      lines.push(`New standing instructions ("${d.title}"):`, d.body.trim(), "");
+      continue;
+    }
+    const diff = lineDiff(old, d.body);
+    if (diff.length) lines.push(`Standing instructions changed ("${d.title}"); follow the new text:`, ...diff, "");
+  }
+  for (const id of Object.keys(base.instructions)) if (!now.some((d) => d.id === id)) lines.push(`Standing instructions withdrawn (${id}): stop following them.`, "");
+  const skillLines = [];
+  for (const s of skillDocs(bundle)) {
+    const old = base.skills[s.id];
+    const where = skillPath(s.skill.name);
+    const read = where ? `re-read \`${where}\` before using it` : `load it with \`bunshin load ${s.id}\` before using it`;
+    if (!old) skillLines.push(`- new skill \`${s.skill.name}\`: ${s.skill.description.replace(/\s+/g, " ").trim()} (${where ? `\`${where}\`` : `\`bunshin load ${s.id}\``})`);
+    else if (old.version !== s.version) skillLines.push(`- \`${s.skill.name}\` updated (v${old.version} \u2192 v${s.version}): ${read}`);
+  }
+  for (const [id, old] of Object.entries(base.skills)) if (!next.skills[id]) skillLines.push(`- \`${old.name}\` was retired: don't use it`);
+  if (skillLines.length) lines.push("Skills:", ...skillLines);
+  if (!lines.length) return { text: "", next };
+  return { text: [`## Bunshin: the library changed during this session (${lib(base.library)} \u2192 ${lib(next.library)})`, ...lines].join("\n").trim(), next };
+}
+function refreshInBackground(v2, store, detach2, cwd, now = Date.now()) {
+  if (!canCall(store.config())) return false;
+  const state = v2.readSyncState();
+  const last = Math.max(Date.parse(state.lastAttemptAt ?? "") || 0, Date.parse(state.lastSyncAt ?? "") || 0);
+  if (now - last < LIVE_REFRESH_MS) return false;
+  v2.writeSyncState({ ...state, lastAttemptAt: new Date(now).toISOString() });
+  detach2(["--root", store.root, "sync", "--quiet"], { cwd });
+  return true;
+}
+
+// src/v2/hooks.ts
 init_reflect2();
 init_repo();
 
@@ -7938,7 +8037,7 @@ async function handleV2(event, ctx) {
     case "session-start":
       return onSessionStart(ctx);
     case "user-prompt-submit":
-      return onPrompt(ctx);
+      return await onPrompt(ctx);
     case "pre-tool-use":
       return onPreToolUse(ctx);
     case "stop":
@@ -7973,6 +8072,10 @@ async function onSessionStart(ctx) {
     }
   }
   const bundle = v2.readBundle();
+  v2.updateSession(id, ctx.cwd, (s) => {
+    s.live = baselineOf(bundle);
+  });
+  const instructions = renderInstructions(bundle);
   const lines = [];
   for (const d of (bundle?.digest ?? []).slice(0, 5)) lines.push(`- ${d}`);
   const proposed = v2.listSuggestions().filter((s) => s.status === "proposed").length;
@@ -7982,16 +8085,60 @@ async function onSessionStart(ctx) {
     lines.push(`Open question${questions.length === 1 ? "" : "s"} for your team (ask the user when it fits; answer with \`bunshin questions answer <id> "<choice>"\`):`);
     for (const q of questions) lines.push(`- [${q.id}] ${q.question}${q.options.length ? ` Options: ${q.options.join(" | ")}` : ""}`);
   }
-  if (!lines.length) return {};
-  return additional("SessionStart", `## Bunshin
-${lines.join("\n")}`);
+  const parts = [instructions, lines.length ? `## Bunshin
+${lines.join("\n")}` : ""].filter(Boolean);
+  if (!parts.length) return {};
+  return additional("SessionStart", parts.join("\n\n"));
+}
+function liveUpdate(v2, ctx, session) {
+  try {
+    refreshInBackground(v2, ctx.store, ctx.detach, ctx.cwd);
+    const bundle = v2.readBundle();
+    if (!session.live) {
+      v2.updateSession(session.sessionId, ctx.cwd, (s) => {
+        s.live = baselineOf(bundle);
+      });
+      return "";
+    }
+    const config = ctx.store.config();
+    const deployed = deployEnabled(config, localView(v2, config, ctx.cwd).ctx);
+    const paths = deployed ? deployPaths() : null;
+    const root = paths ? config.harness === "codex" ? paths.codexSkills : paths.claudeSkills : null;
+    const skillPath = (name) => root ? `${root}/${name}/SKILL.md` : null;
+    const { text: text2, next } = changesSince(session.live, bundle, skillPath);
+    if (next !== session.live) {
+      v2.updateSession(session.sessionId, ctx.cwd, (s) => {
+        s.live = next;
+      });
+    }
+    if (text2) v2.log("v2-live-update", { session: session.sessionId, from: session.live.library ?? null, to: next.library ?? null });
+    return text2;
+  } catch {
+    return "";
+  }
+}
+function skillHint(sec, others) {
+  const also = others.length ? ` Also possibly relevant: ${others.map((t) => `"${t}"`).join(", ")}.` : "";
+  return `Bunshin: the \`${sec.skill.name}\` skill may apply: ${sec.skill.description.replace(/\s+/g, " ").trim()} If it does, invoke it (Skill tool, or \`/${sec.skill.name}\`) before doing this by hand.${also}`;
+}
+async function remoteAuto(ctx, prompt, exclude) {
+  const config = ctx.store.config();
+  if (!canCall(config) || !config.recall.useMothership) return null;
+  const budget = Math.min(2500, ctx.deadline - Date.now() - 600);
+  if (budget < 300) return null;
+  try {
+    const res = await v2api(config, "POST", "/recall/auto", { prompt: prompt.slice(0, 8e3), exclude }, { timeoutMs: budget });
+    return res.available ? res : null;
+  } catch {
+    return null;
+  }
 }
 function hintLine(titles, harness) {
   const quoted = titles.map((t) => `"${t}"`).join(", ");
   const how = harness === "claude-code" ? "If one could change your approach, call the bunshin_recall tool (describe the task abstractly) and load only what you need." : 'If one could change your approach, run `bunshin recall "<the task, abstractly>" --hypothetical "<the lesson you would want>"` and `bunshin load <id>`.';
   return `Bunshin: possibly relevant library sections: ${quoted}. ${how}`;
 }
-function onPrompt(ctx) {
+async function onPrompt(ctx) {
   const prompt = ctx.input.prompt ?? "";
   if (prompt.trimStart().startsWith(REFLECT_MARKER)) return {};
   const v2 = new V2Store(ctx.store);
@@ -8001,11 +8148,30 @@ function onPrompt(ctx) {
     s.lastPrompt = prompt.slice(0, 4e3);
     s.lastActivityAt = now;
   });
-  if (!prompt.trim()) return {};
+  const live = liveUpdate(v2, ctx, session);
+  const withLive = (out) => {
+    if (!live) return out;
+    const text2 = [live, out.hookSpecificOutput?.additionalContext ?? ""].filter(Boolean).join("\n\n");
+    return additional("UserPromptSubmit", text2);
+  };
+  if (!prompt.trim()) return withLive({});
   const config = ctx.store.config();
   const view = localView(v2, config, ctx.cwd);
   const injected = [...session.loaded, ...session.pushed];
   const res = auto(view.sections, view.reader, prompt, { exclude: injected });
+  const remote = await remoteAuto(ctx, prompt, injected);
+  if (remote) {
+    const local = (id) => view.sections.find((s) => s.id === id);
+    if (remote.section) {
+      res.section = local(remote.section.id) ?? remote.section;
+      res.anchor = void 0;
+      res.reason = `dense ${remote.reason ?? ""}`.trim();
+    } else {
+      res.section = void 0;
+      res.hint = (remote.hint ?? []).map((h) => ({ id: h.id, title: local(h.id)?.title ?? h.title }));
+      res.reason = `dense ${remote.reason ?? ""}`.trim();
+    }
+  }
   if (res.section) {
     const sec = res.section;
     v2.updateSession(session.sessionId, ctx.cwd, (s) => {
@@ -8013,16 +8179,18 @@ function onPrompt(ctx) {
       addUnique(s.loaded, sec.id);
     });
     v2.log("v2-auto", { session: session.sessionId, section: sec.id, reason: res.reason });
-    return additional("UserPromptSubmit", renderSection(sec, "your prompt matches it", { ...res.anchor ? { anchor: res.anchor } : {}, deployed: !!sec.skill && deployEnabled(config, view.ctx) }));
+    return withLive(additional("UserPromptSubmit", renderSection(sec, "your prompt matches it", { ...res.anchor ? { anchor: res.anchor } : {}, deployed: !!sec.skill && deployEnabled(config, view.ctx) })));
   }
   const fresh = res.hint.filter((h) => !session.hinted?.includes(h.id)).slice(0, 3);
-  if (!fresh.length) return {};
+  if (!fresh.length) return withLive({});
   v2.updateSession(session.sessionId, ctx.cwd, (s) => {
     s.hinted = s.hinted ?? [];
     addUnique(s.hinted, ...fresh.map((h) => h.id));
     addUnique(s.served, ...fresh.map((h) => h.id));
   });
-  return additional("UserPromptSubmit", hintLine(fresh.map((h) => h.title), config.harness));
+  const topSkill = view.sections.find((s) => s.id === fresh[0].id && s.skill);
+  if (topSkill && deployEnabled(config, view.ctx)) return withLive(additional("UserPromptSubmit", skillHint(topSkill, fresh.slice(1).map((h) => h.title))));
+  return withLive(additional("UserPromptSubmit", hintLine(fresh.map((h) => h.title), config.harness)));
 }
 function toolPaths(input) {
   if (!input || typeof input !== "object") return [];
@@ -8038,16 +8206,21 @@ function onPreToolUse(ctx) {
   const session = touch(v2, ctx, (s) => {
     s.lastActivityAt = (/* @__PURE__ */ new Date()).toISOString();
   });
+  const live = liveUpdate(v2, ctx, session);
+  const withLive = (out) => {
+    if (!live) return out;
+    return additional("PreToolUse", [live, out.hookSpecificOutput?.additionalContext ?? ""].filter(Boolean).join("\n\n"));
+  };
   const raw = toolPaths(ctx.input.tool_input);
-  if (!raw.length) return {};
+  if (!raw.length) return withLive({});
   const config = ctx.store.config();
   const view = localView(v2, config, ctx.cwd);
   const paths = raw.map((p) => relativeToRoot(view.root, p, ctx.cwd)).filter((p) => !!p);
   const text2 = [session.task, session.lastPrompt].filter(Boolean).join("\n");
-  if (!paths.length && !text2) return {};
+  if (!paths.length && !text2) return withLive({});
   const seen = /* @__PURE__ */ new Set([...session.pushed, ...session.loaded]);
   const hits = push(view.sections, view.reader, { paths, text: text2 }).filter((h) => !seen.has(h.section.id)).slice(0, MAX_PUSH);
-  if (!hits.length) return {};
+  if (!hits.length) return withLive({});
   const ids = hits.map((h) => h.section.id);
   v2.updateSession(session.sessionId, ctx.cwd, (s) => {
     addUnique(s.pushed, ...ids);
@@ -8056,7 +8229,7 @@ function onPreToolUse(ctx) {
   });
   v2.log("v2-push", { session: session.sessionId, tool: ctx.input.tool_name, hits: hits.map((h) => `${h.section.id} ${h.trigger}`) });
   const deployed = deployEnabled(config, view.ctx);
-  return additional("PreToolUse", hits.map((h) => renderSection(h.section, h.trigger, { ...h.anchor ? { anchor: h.anchor } : {}, deployed: deployed && !!h.section.skill })).join("\n\n"));
+  return withLive(additional("PreToolUse", hits.map((h) => renderSection(h.section, h.trigger, { ...h.anchor ? { anchor: h.anchor } : {}, deployed: deployed && !!h.section.skill })).join("\n\n")));
 }
 function onStop(ctx) {
   const v2 = new V2Store(ctx.store);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunshin-cc/bunshin",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "Shared memory for company AI agents. Connect Codex, Claude Code, or Pi to Bunshin.",
   "type": "module",
   "bin": {