@bunshin-cc/bunshin 0.4.1 → 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) {

package/package.json

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