@bunshin-cc/bunshin 0.4.0 → 0.4.2

package/dist/bin.js

@@ -879,6 +879,8 @@ function firstHeading(text2) {
 function applyTextOp(text2, op, legacyAnchor = "") {
   const anchor = "anchor" in op && op.anchor || legacyAnchor;
   switch (op.op) {
+    case "situation":
+      return { ok: true, text: text2 };
     case "rewrite":
       return { ok: true, text: op.text };
     case "create":
@@ -1744,6 +1746,11 @@ ${robot ? `- Values that belong to THIS robot or cell (calibration, pixel column
 - Code that should change (a hard-coded constant, a helper) \u2192 describe it as an append to the
   skill's section, stating the change; reconciliation turns it into a harness patch.` : `- Machine specifics and personal preferences \u2192 your own user layer.`}
 - Never include secrets, credentials or customer data.
+- A retrieval miss: if a document in the list above would have helped, but the agent did not use
+  it (the user had to point at it, asked why it was not used, or the agent found it only late), add
+  op "situation" to that document: the request as the user actually phrased it, made general (names
+  and ticket ids replaced by what they stand for), e.g. "run me through an e2e test and what it
+  does". Recall learns from it, so the next such request finds the document.
 
 ## Output
 
@@ -1755,7 +1762,8 @@ At most ${max} suggestions. Schema:
                       | {"op": "create", "section": {"kind": "skill"|"procedure"|"spec"|"verification"|"rule"|"guardrail"|"reference",
                                                       "title": string, "body": string, "when": string,
                                                       "paths"?: string[], "entities"?: string[], "skills"?: string[]}}
-                      | {"op": "param", "key": string, "value": string|number|boolean},
+                      | {"op": "param", "key": string, "value": string|number|boolean}
+                      | {"op": "situation", "text": string},
                   "rationale": string, "urgency": "normal"|"urgent"}]}`;
 }
 function extractJson(text2) {
@@ -1797,6 +1805,10 @@ function parseOp(raw) {
         section: { kind, title, body, when: when || title, paths: strList(s.paths), entities: strList(s.entities).map((e) => e.toLowerCase()), skills: strList(s.skills) }
       };
     }
+    case "situation": {
+      const text2 = clean(o.text);
+      return text2 ? { op: "situation", text: text2.slice(0, 500) } : null;
+    }
     case "param": {
       const key = typeof o.key === "string" ? o.key.trim() : "";
       const v = o.value;
@@ -3599,6 +3611,8 @@ function summarize(op) {
       return clip(op.content === null ? `delete ${op.path}` : `file ${op.path}`);
     case "retire":
       return clip(`retire: ${op.reason}`);
+    case "situation":
+      return clip(`also applies to: ${op.text}`);
   }
 }
 function describeTarget(s, view) {
@@ -8037,7 +8051,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":
@@ -8117,12 +8131,28 @@ function liveUpdate(v2, ctx, session) {
     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);
@@ -8143,6 +8173,19 @@ function onPrompt(ctx) {
   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) => {
@@ -8159,6 +8202,8 @@ function onPrompt(ctx) {
     addUnique(s.hinted, ...fresh.map((h) => h.id));
     addUnique(s.served, ...fresh.map((h) => h.id));
   });
+  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) {

package/package.json

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