@bunshin-cc/bunshin 0.4.5 → 0.4.7

package/dist/bin.js

@@ -183,12 +183,13 @@ function renderIndex(lessons) {
   }
   return lines.join("\n") + "\n";
 }
-var DEFAULT_CONFIG, EMPTY_SESSION, Store;
+var RETIRED_DEFAULT_MODELS, DEFAULT_CONFIG, EMPTY_SESSION, Store;
 var init_store = __esm({
   "src/store.ts"() {
     "use strict";
     init_frontmatter();
     init_util();
+    RETIRED_DEFAULT_MODELS = /* @__PURE__ */ new Set(["claude-fable-5-1"]);
     DEFAULT_CONFIG = {
       orgId: "local",
       userId: process.env.USER || "me",
@@ -199,7 +200,7 @@ var init_store = __esm({
       apiUrl: "",
       scope: "repo",
       harness: "claude-code",
-      model: "claude-fable-5-1",
+      model: "claude-opus-5-5",
       gateModel: "claude-haiku-4-5-20251001",
       backend: "auto",
       recall: { enabled: true, maxLessons: 4, hookBudgetMs: 3500, useMothership: true },
@@ -267,6 +268,8 @@ var init_store = __esm({
           recall: { ...DEFAULT_CONFIG.recall, ...raw.recall ?? {} },
           reflect: { ...DEFAULT_CONFIG.reflect, ...raw.reflect ?? {} }
         };
+        if (RETIRED_DEFAULT_MODELS.has(merged.model)) merged.model = DEFAULT_CONFIG.model;
+        if (process.env.BUNSHIN_MODEL) merged.model = process.env.BUNSHIN_MODEL;
         const harness = process.env.BUNSHIN_HARNESS;
         if (harness === "claude-code" || harness === "codex" || harness === "pi" || harness === "other") merged.harness = harness;
         if (!merged.apiKey && merged.credentialFile) {
@@ -431,9 +434,11 @@ var init_store = __esm({
 function emptyStats() {
   return { served: 0, loaded: 0, helped: 0, hurt: 0, byContext: {} };
 }
+var LEARNING_SIGNALS;
 var init_types = __esm({
   "../core/src/v2/types.ts"() {
     "use strict";
+    LEARNING_SIGNALS = ["steering", "environment", "knowledge", "capability", "approach"];
   }
 });
 
@@ -1521,7 +1526,8 @@ function renderSection(s, trigger, opts = {}) {
   const label2 = s.kind === "guardrail" ? "GUARDRAIL" : s.kind.toUpperCase();
   const src = sourceLabel(s);
   const why = trigger ? `_Why you are seeing this: ${trigger}. Id: ${s.id}_` : `_Id: ${s.id}_`;
-  const head = [`### ${label2} (${src}): ${s.title}`, why];
+  const trial = s.localTrial?.length ? [`_Includes ${s.localTrial.length === 1 ? "an edit" : `${s.localTrial.length} edits`} learned on this machine and not yet reviewed: treat ${s.localTrial.length === 1 ? "it" : "them"} as provisional._`] : [];
+  const head = [`### ${label2} (${src}): ${s.title}`, why, ...trial];
   const max = opts.maxChars ?? 6e3;
   if (s.skill && opts.deployed) {
     const part2 = opts.anchor ? (s.outline ?? []).find((h) => h.anchor === opts.anchor) : void 0;
@@ -1726,9 +1732,20 @@ Lessons already taken from it. Never propose these again, nor a rewording of the
 ${lessons}
 `;
 }
+function stampLesson(op, signal, at) {
+  const day = at.slice(0, 10);
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(day)) return op;
+  const recheck = signal === "environment" ? `; recheck after ${new Date(Date.parse(day) + ENVIRONMENT_RECHECK_DAYS * 864e5).toISOString().slice(0, 10)}` : "";
+  const stamp = `_(learned ${day}${signal ? ` from ${SIGNAL_WORDS[signal]}` : ""}${recheck})_`;
+  if (op.op === "append") return /_\(learned \d{4}-/.test(op.text) ? op : { ...op, text: `${op.text.trimEnd()} ${stamp}` };
+  if (op.op === "create") return /_\(learned \d{4}-/.test(op.section.body) ? op : { ...op, section: { ...op.section, body: `${op.section.body.trimEnd()}
+
+${stamp}` } };
+  return op;
+}
 function summarizeOp(op) {
   const clip2 = (s) => {
-    const one = s.replace(/\s+/g, " ").trim();
+    const one = s.replace(/\s*_\(learned \d{4}-\d{2}-\d{2}[^)]*\)_/g, "").replace(/\s+/g, " ").trim();
     return one.length > 100 ? `${one.slice(0, 97)}\u2026` : one;
   };
   switch (op.op) {
@@ -1783,8 +1800,14 @@ Capture only what would change how a future agent acts, and is recorded nowhere
   b. the environment corrected the agent (a command, test, API, motion or grasp failed, then
      another approach worked): record the trap AND what worked;
   c. knowledge owned by another team surfaced (a process, policy or manual step);
-  d. a capability worked for the first time, or a task was done unusually efficiently.
+  d. a capability worked for the first time, or a task was done unusually efficiently;
+  e. looking back over the whole session, the approach itself was the problem (it took many
+     rounds of fixes, it was over-built, it verified too late) and a different way of working
+     would have avoided it. This has no direct ground truth: say what you would do differently
+     next time, as generally as it truly holds, and where it does not hold.
 "Nothing new" is the expected outcome for most sessions. Never invent a lesson.
+Label each suggestion with its "signal": a \u2192 "steering", b \u2192 "environment", c \u2192 "knowledge",
+d \u2192 "capability", e \u2192 "approach".
 
 ## Where it goes
 
@@ -1797,7 +1820,10 @@ ${index}
 Already captured this session (do not repeat): ${input.captured.length ? input.captured.join(", ") : "none"}
 
 Layers you may target: ${input.layers.join(", ")}.
-- Knowledge about one repo that its team owns \u2192 that repo's section (repo:... ids).
+${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.
+` : ""}- 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").
 ${robot ? `- Values that belong to THIS robot or cell (calibration, pixel columns, colour thresholds under this
@@ -1824,7 +1850,8 @@ At most ${max} suggestions. Schema:
                                                       "paths"?: string[], "entities"?: string[], "skills"?: string[]}}
                       | {"op": "param", "key": string, "value": string|number|boolean}
                       | {"op": "situation", "text": string},
-                  "rationale": string, "urgency": "normal"|"urgent"}]}`;
+                  "rationale": string, "urgency": "normal"|"urgent",
+                  "signal": "steering"|"environment"|"knowledge"|"capability"|"approach"}]}`;
 }
 function extractJson(text2) {
   const fenced = text2.match(/```(?:json)?\s*([\s\S]*?)```/);
@@ -1900,7 +1927,8 @@ function parseReflection(raw, opts = { layers: [] }) {
       target: { ...sectionId ? { sectionId } : {}, ...layer ? { layer } : {} },
       op,
       rationale: clean(it.rationale) || "captured from session",
-      urgency: it.urgency === "urgent" ? "urgent" : "normal"
+      urgency: it.urgency === "urgent" ? "urgent" : "normal",
+      ...LEARNING_SIGNALS.includes(it.signal) ? { signal: it.signal } : {}
     });
     if (out.length >= (opts.max ?? 4)) break;
   }
@@ -1913,8 +1941,9 @@ function toSuggestion(p, base) {
     contextId: base.contextId,
     authorUserId: base.authorUserId,
     target: p.target,
-    op: p.op,
+    op: stampLesson(p.op, p.signal, base.createdAt),
     rationale: p.rationale,
+    ...p.signal ? { signal: p.signal } : {},
     evidenceEpisodeIds: base.episodeId ? [base.episodeId] : [],
     trial: { uses: 0, successes: 0, failures: 0 },
     origin: base.origin,
@@ -1923,12 +1952,21 @@ function toSuggestion(p, base) {
     createdAt: base.createdAt
   };
 }
-var REFLECT_MARKER, REFLECT_SCHEMA, KINDS, anchorOf, clean, strList;
+var REFLECT_MARKER, ENVIRONMENT_RECHECK_DAYS, SIGNAL_WORDS, REFLECT_SCHEMA, KINDS, anchorOf, clean, strList;
 var init_reflect = __esm({
   "../core/src/v2/reflect.ts"() {
     "use strict";
     init_redact();
+    init_types();
     REFLECT_MARKER = "BUNSHIN:reflect";
+    ENVIRONMENT_RECHECK_DAYS = 90;
+    SIGNAL_WORDS = {
+      steering: "a person's correction",
+      environment: "the environment",
+      knowledge: "another team's knowledge",
+      capability: "a first success",
+      approach: "reflection on the approach"
+    };
     REFLECT_SCHEMA = {
       type: "object",
       additionalProperties: false,
@@ -1944,7 +1982,8 @@ var init_reflect = __esm({
               target: { type: "object", properties: { sectionId: { type: "string" }, layer: { type: "string" } } },
               op: { type: "object" },
               rationale: { type: "string" },
-              urgency: { type: "string", enum: ["normal", "urgent"] }
+              urgency: { type: "string", enum: ["normal", "urgent"] },
+              signal: { type: "string", enum: ["steering", "environment", "knowledge", "capability", "approach"] }
             }
           }
         }
@@ -2003,6 +2042,14 @@ var init_research = __esm({
   }
 });
 
+// ../core/src/v2/profile.ts
+var init_profile = __esm({
+  "../core/src/v2/profile.ts"() {
+    "use strict";
+    init_types();
+  }
+});
+
 // ../core/src/v2/index.ts
 var init_v2 = __esm({
   "../core/src/v2/index.ts"() {
@@ -2019,6 +2066,7 @@ var init_v2 = __esm({
     init_reconcile();
     init_release();
     init_research();
+    init_profile();
   }
 });
 
@@ -2682,7 +2730,7 @@ function planDeploy(bundle, p, harnesses) {
     if (!prev || (LAYER_RANK[layerKind(s.layer)] ?? 0) > (LAYER_RANK[layerKind(prev.layer)] ?? 0)) byName.set(s.skill.name, s);
   }
   const skills = [...byName.values()].sort((a, b) => a.skill.name.localeCompare(b.skill.name));
-  const instructions = active.filter((s) => s.delivery === "always" && !s.skill).sort((a, b) => (a.packPath ?? a.title).localeCompare(b.packPath ?? b.title));
+  const instructions = active.filter((s) => s.delivery === "always" && !s.skill && !s.profileOf).sort((a, b) => (a.packPath ?? a.title).localeCompare(b.packPath ?? b.title));
   const plan = { docs: /* @__PURE__ */ new Map(), instructions, skills };
   const roots = [...harnesses.has("claude-code") ? [p.claudeSkills] : [], ...harnesses.has("codex") ? [p.codexSkills] : []];
   for (const s of skills) {
@@ -3197,13 +3245,25 @@ function baselineOf(bundle) {
 }
 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");
+  const profiles = docs.filter((d) => d.profileOf);
+  const standing = docs.filter((d) => !d.profileOf);
+  const parts = [];
+  if (profiles.length) {
+    parts.push(
+      ["## Who you work for (Bunshin profile)", "Bunshin keeps this current from their sessions and corrections, and tells you when it changes.", "", ...profiles.map((d) => d.body.trim())].join("\n")
+    );
+  }
+  if (standing.length) {
+    parts.push(
+      [
+        `## 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.",
+        "",
+        ...standing.map((d) => d.body.trim())
+      ].join("\n")
+    );
+  }
+  return parts.join("\n\n");
 }
 function lineDiff(before, after, max = MAX_DIFF_LINES) {
   const a = before.split("\n");
@@ -3237,11 +3297,11 @@ function changesSince(base, bundle, skillPath) {
     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(), "");
+      lines.push(d.profileOf ? `The profile of the person you work for ("${d.title}"):` : `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, "");
+    if (diff.length) lines.push(d.profileOf ? `The profile of the person you work for changed ("${d.title}"):` : `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 = [];
@@ -3707,13 +3767,13 @@ function applyOverlays(sections, overlays, ctx) {
     if (!ACTIVE_OVERLAY.has(o.status) || o.kind !== "local-section") continue;
     if (o.op.op === "create") {
       const id = o.sectionId || localSectionId(o.suggestionId);
-      sections.set(id, draftToSection(id, o.op.section, ctx, ownLayer(ctx), o.appliedAt));
+      sections.set(id, { ...draftToSection(id, o.op.section, ctx, ownLayer(ctx), o.appliedAt), localTrial: [o.suggestionId] });
       continue;
     }
     const base = o.sectionId ? sections.get(o.sectionId) : void 0;
     if (!base) continue;
     const res = applyOpToBody(base.body, o.op);
-    if (res.ok && res.text !== base.body) sections.set(base.id, { ...base, body: res.text, updatedAt: o.appliedAt });
+    if (res.ok && res.text !== base.body) sections.set(base.id, { ...base, body: res.text, updatedAt: o.appliedAt, localTrial: [...base.localTrial ?? [], o.suggestionId] });
   }
 }
 function localView(v2, config, cwd, opts = {}) {
@@ -4382,9 +4442,9 @@ function episodeIdFor(contextId, sessionId) {
   return `e_${createHash2("sha256").update(`${contextId}
 ${sessionId}`).digest("hex").slice(0, 16)}`;
 }
-function runClaudeFork(sessionId, prompt, { cwd, timeoutMs = FORK_TIMEOUT_MS } = {}) {
+function runClaudeFork(sessionId, prompt, { cwd, model, timeoutMs = FORK_TIMEOUT_MS } = {}) {
   const bin = process.env.BUNSHIN_CLAUDE_BIN || "claude";
-  const args = ["-p", "--resume", sessionId, "--fork-session", "--output-format", "json", prompt];
+  const args = ["-p", "--resume", sessionId, "--fork-session", "--output-format", "json", ...model ? ["--model", model] : [], prompt];
   return new Promise((resolve) => {
     let out = "";
     let err = "";
@@ -4482,20 +4542,25 @@ async function runReflectionV2(store, opts) {
     const episodeId = episodeIdFor(view.ctx.id, opts.sessionId);
     const prior = session.suggestionIds.map((id) => v2.readSuggestion(id)).filter((s) => !!s);
     const captured = [.../* @__PURE__ */ new Set([...session.captured, ...prior.map((s) => s.target.sectionId ?? localSectionId(s.id))])];
-    const index = reflectionIndex(view, [...session.loaded, ...session.pushed, ...session.served], session.task, opts.focus, humanTurnsOf(session.transcriptPath));
+    const profile = view.sections.find((s) => s.profileOf && s.profileOf === config.userId && s.status === "active");
+    const index = [
+      ...profile ? [{ id: profile.id, kind: profile.kind, layer: profile.layer, title: profile.title, when: "how the person you work for works", ...profile.outline?.length ? { outline: profile.outline } : {} }] : [],
+      ...reflectionIndex(view, [...session.loaded, ...session.pushed, ...session.served], session.task, opts.focus, humanTurnsOf(session.transcriptPath)).filter((s) => s.id !== profile?.id)
+    ];
     const harness = session.harness ?? config.harness;
     const facts = readFacts(session.transcriptPath);
     const turns = facts?.turns.length ?? 0;
     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 } : {} };
+    const promptBase = { contextKind: view.ctx.kind, layers: view.layers, index, captured, ...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 });
+      const fork = await runClaudeFork(opts.sessionId, buildReflectPrompt(promptBase), { cwd: session.cwd, model: config.model });
       v2.log("v2-reflect-fork", {
         session: opts.sessionId,
         ok: fork.ok,
+        model: config.model,
         cache: true,
         cache_read_input_tokens: fork.usage?.cache_read_input_tokens ?? null,
         cache_creation_input_tokens: fork.usage?.cache_creation_input_tokens ?? null,
@@ -4784,6 +4849,13 @@ var init_uicmd = __esm({
 // src/v2/hooks.ts
 import fs14 from "node:fs";
 import path11 from "node:path";
+function inContext(s) {
+  return s.inContext ?? [...s.loaded, ...s.pushed];
+}
+function markInContext(s, ...ids) {
+  s.inContext = s.inContext ?? [...s.loaded, ...s.pushed];
+  addUnique(s.inContext, ...ids);
+}
 function touch(v2, ctx, patch = () => {
 }) {
   const id = ctx.input.session_id || "no-session";
@@ -4852,6 +4924,7 @@ function liveSummary(text2) {
   for (const m of text2.matchAll(/- `([^`]+)` updated \((v\d+ → v\d+)\)/g)) items.push(`${m[1]} ${m[2]}`);
   for (const m of text2.matchAll(/- `([^`]+)` was retired/g)) items.push(`${m[1]} retired`);
   if (/Standing instructions (changed|withdrawn)|New standing instructions/.test(text2)) items.push("standing instructions changed");
+  if (/The profile of the person you work for/.test(text2)) items.push("your profile");
   return `library updated${range ? ` (${range[2]})` : ""}: ${items.join(", ") || "changes delivered to the agent"}`;
 }
 async function dispatch(event, ctx) {
@@ -4996,7 +5069,7 @@ async function onPrompt(ctx) {
   if (!prompt.trim()) return withLive({});
   const config = ctx.store.config();
   const view = localView(v2, config, ctx.cwd);
-  const injected = [...session.loaded, ...session.pushed];
+  const injected = inContext(session);
   const res = auto(view.sections, view.reader, prompt, { exclude: injected });
   const remote = await remoteAuto(ctx, prompt, injected);
   if (remote) {
@@ -5016,6 +5089,7 @@ async function onPrompt(ctx) {
     v2.updateSession(session.sessionId, ctx.cwd, (s) => {
       addUnique(s.served, sec.id);
       addUnique(s.loaded, sec.id);
+      markInContext(s, sec.id);
     });
     v2.log("v2-auto", { session: session.sessionId, section: sec.id, reason: res.reason });
     updateFeed(v2, session.sessionId, (f) => {
@@ -5069,13 +5143,14 @@ function onPreToolUse(ctx) {
   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 withLive({});
-  const seen = /* @__PURE__ */ new Set([...session.pushed, ...session.loaded]);
+  const seen = new Set(inContext(session));
   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 withLive({});
   const ids = hits.map((h) => h.section.id);
   v2.updateSession(session.sessionId, ctx.cwd, (s) => {
     addUnique(s.pushed, ...ids);
     addUnique(s.loaded, ...ids);
+    markInContext(s, ...ids);
     addUnique(s.served, ...ids);
   });
   v2.log("v2-push", { session: session.sessionId, tool: ctx.input.tool_name, hits: hits.map((h) => `${h.section.id} ${h.trigger}`) });
@@ -5278,7 +5353,10 @@ function onSessionEnd(ctx) {
 function onPreCompact(ctx) {
   const v2 = new V2Store(ctx.store);
   const config = ctx.store.config();
-  const session = touch(v2, ctx);
+  const session = touch(v2, ctx, (s) => {
+    s.inContext = [];
+    s.hinted = [];
+  });
   if (!config.reflect.enabled) return {};
   const scan = scanTranscript(ctx.input.transcript_path ?? session.transcriptPath);
   const from = reflectCursor(session, scan.facts.turns.length);

package/package.json

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