@bunshin-cc/bunshin 0.6.4 → 0.6.5

package/dist/bin.js

@@ -1749,7 +1749,7 @@ function servable(sections, reader) {
   return [...out.values()];
 }
 function recallable(sections, reader) {
-  return servable(sections, reader).filter((s) => s.delivery !== "always" && s.delivery !== "stop");
+  return servable(sections, reader).filter((s) => s.delivery !== "always" && s.delivery !== "stop" && s.delivery !== "reflect");
 }
 function passagesOfSection(s) {
   const hit = passageCache.get(s);
@@ -1965,6 +1965,50 @@ var init_engine = __esm({
   }
 });
 
+// ../core/src/v2/guidelines.ts
+function reflectionGuidelines(sections, reader, opts = {}) {
+  const pool = reader ? servable(sections, reader) : sections;
+  return pool.filter((s) => s.delivery === "reflect" && s.status === "active").filter((s) => !opts.layer || s.layer === "org" || opts.layer === s.layer || opts.layer.startsWith(`${s.layer}/`)).sort((a, b) => generality(a.layer) - generality(b.layer) || a.id.localeCompare(b.id)).map((s) => ({ id: s.id, title: s.title, layer: s.layer, body: s.body }));
+}
+function guidelineRules(body) {
+  const at = body.search(/^## /m);
+  const rules = (at < 0 ? body : body.slice(at)).replace(/^## Rules[^\n]*\n/m, "").trim();
+  return rules;
+}
+function guidelinesSection(gs, opts = {}) {
+  const list2 = gs ?? [];
+  const withRules = list2.map((g) => ({ g, rules: guidelineRules(g.body) })).filter((x) => x.rules);
+  const rules = withRules.length ? `These rules come from reviewers' feedback on earlier lessons. Follow them; where they conflict
+with the defaults below, they win.
+
+${withRules.map(({ g, rules: rules2 }) => `### ${g.title}${list2.length > 1 ? ` (${g.layer})` : ""}
+
+${rules2}`).join("\n\n")}
+` : "";
+  const target = list2[0];
+  const route = opts.forReflection && target ? `${rules ? "\n" : ""}When the person in this session gives feedback about lessons themselves (how they should be
+captured or written, what to leave out: for example "/learn do not write ticket-specific details"),
+that is a rule for these guidelines, not for a task document: op "append" to ${target.id},
+anchor "${GUIDELINES_ANCHOR}", one general rule in the imperative, with the reason.
+` : "";
+  if (!rules && !route) return "";
+  return `
+## How this company wants lessons written (reflection guidelines)
+
+${rules}${route}`;
+}
+var GUIDELINES_ANCHOR, generality;
+var init_guidelines = __esm({
+  "../core/src/v2/guidelines.ts"() {
+    "use strict";
+    init_types();
+    init_layers();
+    init_engine();
+    GUIDELINES_ANCHOR = "rules";
+    generality = (l) => ({ org: 0, dept: 1, fleet: 1, team: 2, arm: 3, mount: 3, robot: 4, user: 4 })[layerKind(l)] ?? 5;
+  }
+});
+
 // ../core/src/redact.ts
 function secretWord(w) {
   if (/tokeniz/.test(w)) return false;
@@ -2569,7 +2613,7 @@ ${input.digestNote ? `${input.digestNote}
 ${input.focus ? `## What to capture
 
 ${input.focus}
-` : ""}
+` : ""}${guidelinesSection(input.guidelines, { forReflection: true })}
 ## When something is worth capturing
 
 Capture only what would change how a future agent acts, and is recorded nowhere durable:
@@ -2586,6 +2630,16 @@ Capture only what would change how a future agent acts, and is recorded nowhere
 Label each suggestion with its "signal": a \u2192 "steering", b \u2192 "environment", c \u2192 "knowledge",
 d \u2192 "capability", e \u2192 "approach".
 
+## How to write it
+
+A lesson is read by agents on other tasks, months from now. Write the rule, not the story:
+- Say when it applies, what to do, and why, so it holds beyond this session.
+- Leave out what only this session had: dates, how many tickets or items there were, ticket ids,
+  the particular cases it happened on, who asked. Name a specific repo, service, file, command or
+  spec only when the lesson is about that thing. One short generic example is fine when it makes
+  the rule clearer.
+- The date and source are added automatically; never write them yourself.
+
 ## Where it goes
 
 Every entry is a whole document (a skill, a spec, a policy). Prefer editing an existing document
@@ -2772,6 +2826,7 @@ var REFLECT_MARKER, ENVIRONMENT_RECHECK_DAYS, SIGNAL_WORDS, REFLECT_SCHEMA, KIND
 var init_reflect = __esm({
   "../core/src/v2/reflect.ts"() {
     "use strict";
+    init_guidelines();
     init_redact();
     init_types();
     REFLECT_MARKER = "BUNSHIN:reflect";
@@ -2866,6 +2921,7 @@ var init_reconcile = __esm({
 var init_merge = __esm({
   "../core/src/v2/merge.ts"() {
     "use strict";
+    init_guidelines();
     init_text();
     init_reconcile();
     init_markdown();
@@ -2918,6 +2974,7 @@ var init_v2 = __esm({
     init_release();
     init_research();
     init_profile();
+    init_guidelines();
   }
 });
 
@@ -5814,7 +5871,8 @@ async function runReflectionV2(store, opts) {
     const from = reflectCursor(session, turns);
     const lessons = [.../* @__PURE__ */ new Set([...prior.map(lessonLine), ...session.serverLessons ?? []])].slice(0, 40);
     const earlier = from > 0 || lessons.length ? { ...from > 0 && facts ? { from: anchorAt(facts, from) } : {}, lessons } : void 0;
-    const promptBase = { contextKind: view.ctx.kind, layers: view.layers, index, captured, ...opts.focus ? { focus: opts.focus } : {}, ...earlier ? { earlier } : {}, ...profile ? { profileId: profile.id } : {} };
+    const guidelines = reflectionGuidelines(view.sections, view.reader);
+    const promptBase = { contextKind: view.ctx.kind, layers: view.layers, index, captured, guidelines, ...opts.focus ? { focus: opts.focus } : {}, ...earlier ? { earlier } : {}, ...profile ? { profileId: profile.id } : {} };
     let raw = null;
     if (harness === "claude-code") {
       const fork = await runClaudeFork(opts.sessionId, buildReflectPrompt(promptBase), { cwd: session.cwd, model: config.model });

package/package.json

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