@bunshin-cc/bunshin 0.8.1 → 0.9.0

package/dist/bin.js

@@ -2770,8 +2770,17 @@ A lesson is read by agents on other tasks, months from now. Write the rule, not
 
 Every entry is a whole document (a skill, a spec, a policy). Prefer editing an existing document
 over creating one, and aim the edit: "anchor" names the heading (from its headings list) the text
-belongs under, so it lands in the right part of the document. Library documents relevant to this
-session:
+belongs under, so it lands in the right part of the document.
+
+Steering and approach lessons (a, e) are the exception: each is its own short lesson. Use op
+"create" with kind "rule": a title naming the behaviour, a "when" naming the situations it applies
+in (as the user would phrase a request there, even one that never mentions it), and a body of at
+most about 120 words: the rule, why, and when it was learned. Do not append such a lesson inside a
+long skill or procedure: a rule buried in a long document goes unfollowed even when the document is
+loaded, and the user ends up repeating it. If a short rule in the list below already says it, append
+to that rule instead. Traps, procedures and facts (b, c, d) still go into the document they belong to.
+
+Library documents relevant to this session:
 ${index}
 ${input.skills?.length ? `
 Skills in the library (target any of them by id, listed here or not):
@@ -2791,9 +2800,9 @@ A fact, command or habit of this project \u2192 this project. True of every proj
 that group. True anywhere this workspace works \u2192 org. Lessons that come up again in other scopes
 are widened by the nightly generalization pass, so a narrow scope is never a loss. Name it as
 "layer" in the target of a new document (an edit keeps the document's own scope).
-` : ""}${input.profileId ? `- How THIS person works, prefers or wants things done (a steering or approach lesson about them,
-  not about the task) \u2192 op "append" to their profile ${input.profileId}, anchor "how-i-work".
-  A lesson for anyone doing the task belongs in the task's document instead.
+` : ""}${input.profileId ? `- How THIS person works in every task alike (tone, length, how they like to be asked) \u2192
+  op "append" to their profile ${input.profileId}, anchor "how-i-work". A preference that applies in
+  one kind of situation (how they want PRs, reports, deploys) is a short rule lesson in their layer.
 ` : ""}- Knowledge about one repo that its team owns \u2192 that repo's section (repo:... ids).
 - Cross-repo facts, another team's rules, non-code processes \u2192 a Bunshin section at the right layer.
 - If it only holds in some contexts, use op "append" with a "condition" (e.g. "objects over 50 g").
@@ -6878,13 +6887,42 @@ 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, source) {
+function lastReply(transcriptPath, maxBytes = 256e3) {
+  if (!transcriptPath) return void 0;
+  try {
+    const fd = fs18.openSync(transcriptPath, "r");
+    try {
+      const size = fs18.fstatSync(fd).size;
+      const len = Math.min(size, maxBytes);
+      const buf = Buffer.alloc(len);
+      fs18.readSync(fd, buf, 0, len, size - len);
+      const lines = buf.toString("utf8").split("\n");
+      for (let i = lines.length - 1; i >= 0; i--) {
+        let m;
+        try {
+          m = JSON.parse(lines[i]);
+        } catch {
+          continue;
+        }
+        if (m?.type !== "assistant" || m.isSidechain) continue;
+        const c = m.message?.content;
+        const text2 = Array.isArray(c) ? c.filter((b) => b?.type === "text").map((b) => String(b.text ?? "")).join("\n") : typeof c === "string" ? c : "";
+        if (text2.trim()) return redact2(text2.trim()).slice(0, 1500);
+      }
+    } finally {
+      fs18.closeSync(fd);
+    }
+  } catch {
+  }
+  return void 0;
+}
+async function remoteAuto(ctx, prompt, exclude, source, context) {
   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: redact2(prompt).slice(0, 8e3), exclude, ...source ? { source } : {} }, { timeoutMs: budget });
+    const res = await v2api(config, "POST", "/recall/auto", { prompt: redact2(prompt).slice(0, 8e3), exclude, ...source ? { source } : {}, ...context ? { context } : {} }, { timeoutMs: budget });
     return res.available ? res : null;
   } catch {
     return null;
@@ -6908,6 +6946,7 @@ async function onPrompt(ctx) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const session = touch(v2, ctx, (s) => {
     if (!s.task && prompt.trim()) s.task = redact2(prompt.trim()).slice(0, 2e3);
+    if (s.lastPrompt && prompt.trim()) s.recentPrompts = [...s.recentPrompts ?? [], s.lastPrompt.slice(0, 600)].slice(-3);
     s.lastPrompt = redact2(prompt).slice(0, 4e3);
     s.lastActivityAt = now;
   });
@@ -6939,19 +6978,45 @@ async function onPrompt(ctx) {
     return withLive(deployed || !fresh2 ? {} : additional("UserPromptSubmit", renderSection(named, why, { deployed: false })));
   }
   const res = auto(view.sections, view.reader, prompt, { exclude: injected });
-  const remote = await remoteAuto(ctx, prompt, injected, session.source);
+  const recent = session.recentPrompts ?? [];
+  const context = {
+    ...recent.length && session.task ? { first: session.task.slice(0, 1e3) } : {},
+    ...recent.length ? { recent } : {}
+  };
+  const reply = recent.length ? lastReply(ctx.input.transcript_path ?? session.transcriptPath) : void 0;
+  if (reply) context.reply = reply;
+  const remote = await remoteAuto(ctx, prompt, injected, session.source, Object.keys(context).length ? context : void 0);
+  const local = (id) => view.sections.find((s) => s.id === id);
   if (remote) {
-    const local = (id) => view.sections.find((s) => s.id === id);
+    const why = remote.router ? remote.reason ?? `router ${remote.router}` : `dense ${remote.reason ?? ""}`.trim();
     if (remote.section) {
       res.section = local(remote.section.id) ?? remote.section;
       res.anchor = void 0;
-      res.reason = `dense ${remote.reason ?? ""}`.trim();
+      res.reason = why;
     } 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();
+      res.reason = why;
     }
   }
+  const rules = (remote?.rules ?? []).filter((r) => !injected.includes(r.id) && r.id !== res.section?.id).map((r) => local(r.id) ?? r);
+  let lessons = "";
+  if (rules.length) {
+    v2.updateSession(session.sessionId, ctx.cwd, (s) => {
+      for (const r of rules) {
+        addUnique(s.served, r.id);
+        addUnique(s.loaded, r.id);
+        markInContext(s, r.id);
+      }
+    });
+    v2.log("v2-auto-rules", { session: session.sessionId, sections: rules.map((r) => r.id), reason: res.reason });
+    updateFeed(v2, session.sessionId, (f) => {
+      for (const r of [...rules].reverse()) addServed(f, { id: r.id, title: r.title, kind: r.kind, how: "auto", why: "a lesson learned before applies here" });
+      addEvent(f, "served", `lessons: ${rules.map((r) => r.title).join(", ")}`);
+    });
+    lessons = rules.map((r) => renderSection(r, "a lesson learned before applies to this work", { deployed: false })).join("\n\n");
+  }
+  const withLessons = (text2) => withLive(additional("UserPromptSubmit", [text2, lessons].filter(Boolean).join("\n\n")));
   if (res.section) {
     const sec = res.section;
     v2.updateSession(session.sessionId, ctx.cwd, (s) => {
@@ -6965,10 +7030,10 @@ async function onPrompt(ctx) {
       addServed(f, { id: sec.id, title: sec.title, kind: sec.kind, ...sec.skill ? { skill: sec.skill.name } : {}, how: "auto", why });
       addEvent(f, "served", `served ${label({ ...sec.skill ? { skill: sec.skill.name } : {}, title: sec.title, kind: sec.kind })} \u2014 ${why}`);
     });
-    return withLive(additional("UserPromptSubmit", renderSection(sec, "your prompt matches it", { ...res.anchor ? { anchor: res.anchor } : {}, deployed: !!sec.skill && deployEnabled(config, view.ctx) })));
+    return withLessons(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 withLive({});
+  const fresh = res.hint.filter((h) => !session.hinted?.includes(h.id) && !rules.some((r) => r.id === h.id)).slice(0, 3);
+  if (!fresh.length) return withLessons("");
   v2.updateSession(session.sessionId, ctx.cwd, (s) => {
     s.hinted = s.hinted ?? [];
     addUnique(s.hinted, ...fresh.map((h) => h.id));
@@ -6982,8 +7047,8 @@ async function onPrompt(ctx) {
     addEvent(f, "hint", `possibly relevant: ${fresh.map((h) => h.title).join(", ")}`);
   });
   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)));
+  if (topSkill && deployEnabled(config, view.ctx)) return withLessons(skillHint(topSkill, fresh.slice(1).map((h) => h.title)));
+  return withLessons(hintLine(fresh.map((h) => h.title), config.harness));
 }
 function toolPaths(input) {
   if (!input || typeof input !== "object") return [];

package/package.json

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