pi-beyin 0.1.8 → 0.1.10

package/README.md

@@ -26,6 +26,26 @@ text found in notes, imported transcripts or tool output.
 
 The extensions without a vault are no-ops; `context` and `damitma` have nothing to read.
 
+## Who this is for
+
+- You already use a **beyin vault** — a directory with `beyin.py` that brings its own installer and updater.
+- You run **pi** and want that vault wired into pi.
+- You have **CommandCode** access if you want Jev and the advisor tools. Without it, context injection,
+  the receipt reminder and the distillation offer still work; only scoring and the `beyin_jev_*` tools
+  stay inert.
+
+With CommandCode, install the official provider so Jev can reuse its key instead of a separate secret:
+
+```bash
+pi install npm:@commandcode/pi-commandcode-provider
+```
+
+Otherwise put `CMD_API_KEY=...` in `~/.config/beyin/jev-commandcode.env` (or export it).
+
+The harness patch only knows the code shapes it was written against. On an unfamiliar vault it prints
+warnings, leaves the files untouched (fail-soft) and `receipt --harness pi` stays unavailable until the
+patterns match — nothing breaks, the work is just labelled with another harness.
+
 ## Install
 
 ```bash
@@ -50,7 +70,9 @@ the context twice.
 
 Environment: `BEYIN_VAULT`, `BEYIN_PYTHON`, `BEYIN_HOOK_CONFIG`, `BEYIN_DAMITMA_CONFIG`,
 `BEYIN_JEV_CONFIG`, `BEYIN_CONTEXT_CHARS`, `BEYIN_REMINDERS=0`, `BEYIN_INCLUDE_VAULT=1`,
-`BEYIN_DAMITMA=0`, `BEYIN_JEV=0`, `BEYIN_DISABLE=1`, `BEYIN_DEBUG=1`, `BEYIN_PI_PATCH`,
+`BEYIN_DAMITMA=0`, `BEYIN_JEV=0`, `BEYIN_DISABLE=1`, `BEYIN_DEBUG=1`, `BEYIN_PI_PATCH`, `BEYIN_LANG` (`tr`
+by default; `en` switches the injected notices and command descriptions to English — the
+`beyin_jev_*` tool schema text is still Turkish),
 `BEYIN_JEV_MODEL`, `BEYIN_JEV_API_KEY` / `CMD_API_KEY` / `COMMAND_CODE_API_KEY`,
 `BEYIN_FORCE_REMINDER=1`.
 

package/extensions/context.ts

@@ -43,6 +43,8 @@ const REMINDERS = process.env.BEYIN_REMINDERS !== "0";
 const INCLUDE_VAULT = process.env.BEYIN_INCLUDE_VAULT === "1";
 const DISABLED = process.env.BEYIN_DISABLE === "1";
 const DEBUG = process.env.BEYIN_DEBUG === "1";
+/** Model-facing fixed texts: "tr" (default) or "en" via BEYIN_LANG. */
+const LANG = /^en/i.test(process.env.BEYIN_LANG || "") ? "en" : "tr";
 
 const SYNTHETIC_PREFIXES = [
 	"<task-notification>",
@@ -264,7 +266,8 @@ interface JevPrefs {
 	/**
 	 * Topicality bar — on the **score scale** (0..2), not a probability.
 	 *
-	 * The score question is a 3-level ordinal: `İlgisiz=0 · Arka plan=1 · Doğrudan ilgili=2`
+	 * The score question is a 3-level ordinal (0 irrelevant, 1 background, 2 directly relevant);
+	 * the criteria labels themselves are Turkish strings in the code below.
 	 * (the same three levels as Python `CRITERIA`). Expected score = weighted mean of the
 	 * distribution -> under linear mapping **score ≈ 2·p** (p = probability).
 	 *
@@ -647,13 +650,21 @@ export default function beyinContext(pi: ExtensionAPI) {
 		// Receipt reminder from the previous turn (full mode only); then reset the flags for the new turn.
 		let reminder: string | undefined;
 		if (REMINDERS && mode === "full" && prevEdited && !prevRecorded) {
+			const receiptCmd = `python3 ${path.join(VAULT, "beyin.py")} receipt --harness pi --event-id EVENT_ID --summary "..." --ref <vault-relative-path>`;
 			reminder =
-				"## İkinci beyin — kayıt gerekli\n" +
-				"Önceki turda dosya düzenlendi ve ikinci beyne kayıt düşülmedi. " +
-				"Bu mesajı yanıtlamadan ÖNCE kaydet: vault dosyasıysa " +
-				`\`python3 ${path.join(VAULT, "beyin.py")} receipt --harness pi --event-id EVENT_ID --summary "..." --ref <vault-goreli-yol>\`; ` +
-				"vault dışı bir işse `note-create`/`task-create` ile vault'a kısa bir sonuç/görev notu yaz. " +
-				"Kalıcı bir öğrenim varsa `knowledge/` altına damıt. Sonra normal yanıtı ver.";
+				LANG === "en"
+					? "## Second brain — record required\n" +
+						"The previous turn edited files without recording anything in the second brain. " +
+						"Record BEFORE answering this message: for a vault file run " +
+						`\`${receiptCmd}\`; ` +
+						"for work outside the vault write a short result/task note with `note-create`/`task-create`. " +
+						"If there is a durable lesson, distill it under `knowledge/`. Then answer normally."
+					: "## İkinci beyin — kayıt gerekli\n" +
+						"Önceki turda dosya düzenlendi ve ikinci beyne kayıt düşülmedi. " +
+						"Bu mesajı yanıtlamadan ÖNCE kaydet: vault dosyasıysa " +
+						`\`${receiptCmd}\`; ` +
+						"vault dışı bir işse `note-create`/`task-create` ile vault'a kısa bir sonuç/görev notu yaz. " +
+						"Kalıcı bir öğrenim varsa `knowledge/` altına damıt. Sonra normal yanıtı ver.";
 		}
 		prevEdited = false;
 		prevRecorded = false;

package/extensions/damitma.ts

@@ -2,7 +2,7 @@
  * Beyin distillation — a knowledge-distillation SUGGESTION at turn/session end.
  *
  * Why: in beyin's bare form the concept/distillation work is done by the active
- * agent, not a background model (the V2 background compiler is retired). But the
+ * agent, not a background model. But the
  * "was the lesson distilled" step could be skipped silently. If a turn wrote a record
  * to the second brain without distilling under `knowledge/`, this extension injects a
  * short "offer distillation candidates" instruction at the end of the turn.
@@ -43,6 +43,8 @@ const HOOK_CONFIG_FILE = process.env.BEYIN_HOOK_CONFIG || path.join(HOME, ".conf
 const DEFAULT_EXCLUDES: string[] = [];
 const DISABLED = process.env.BEYIN_DAMITMA === "0" || process.env.BEYIN_DISABLE === "1";
 const DEBUG = process.env.BEYIN_DEBUG === "1";
+/** Model-facing fixed texts: "tr" (default) or "en" via BEYIN_LANG. */
+const LANG = /^en/i.test(process.env.BEYIN_LANG || "") ? "en" : "tr";
 
 const RECEIPT_RE = /(?:^|\s)beyin\.py\s+(?:receipt|note-create|task-create|task-update)\b/;
 const KNOWLEDGE_RE = /(^|[\\/])knowledge[\\/]/;
@@ -127,6 +129,18 @@ function insideVault(p: string): boolean {
 }
 
 function instruction(maxCandidates: number): string {
+	if (LANG === "en") {
+		return [
+			"## Second brain — distillation offer",
+			"This turn wrote to the second brain but nothing was distilled under `knowledge/`.",
+			"Now give the user a SHORT distillation offer (a short visible list):",
+			`- At most ${maxCandidates} candidates. One line each: **title** — one sentence — source (file/receipt path).`,
+			"- Offer only reusable lessons/decisions/concepts/methods; never invent candidates to fill a quota, never offer transient detail.",
+			'- If there is no durable lesson, skip the offer and say "nothing durable to distill" in one sentence.',
+			"- Write nothing under `knowledge/` before the user approves. After approval, write it with `beyin.py note-create` and add it to the receipt refs.",
+			"- If improving an existing knowledge note is enough, say so; do not open a new file.",
+		].join("\n");
+	}
 	return [
 		"## İkinci beyin — damıtma önerisi",
 		"Bu turda ikinci beyne kayıt düşüldü ama kalıcı bilgi `knowledge/` altına damıtılmadı.",
@@ -226,13 +240,13 @@ export default function beyinDamitma(pi: ExtensionAPI) {
 
 	// Manual trigger: /damitma — asks for the same suggestion right now.
 	pi.registerCommand("damitma", {
-		description: "İkinci beyin damıtma önerisini şimdi iste",
+		description: LANG === "en" ? "Ask for the second-brain distillation offer now" : "İkinci beyin damıtma önerisini şimdi iste",
 		handler: async (_args, ctx: ExtensionContext) => {
 			pi.sendMessage(
 				{ customType: "beyin-damitma", display: false, content: instruction(config.maxCandidates) },
 				{ triggerTurn: true },
 			);
-			ctx.ui.notify("Damıtma önerisi istendi", "info");
+			ctx.ui.notify(LANG === "en" ? "Distillation offer requested" : "Damıtma önerisi istendi", "info");
 		},
 	});
 }

package/extensions/jev.ts

@@ -40,6 +40,8 @@ const DEFAULT_MODEL = "typesafe/jev";
 const KEY_FILE = path.join(HOME, ".config", "beyin", "jev-commandcode.env");
 const CONFIG_FILE = path.join(HOME, ".config", "beyin", "jev.json");
 const DEBUG = process.env.BEYIN_DEBUG === "1";
+/** User-facing fixed texts: "tr" (default) or "en" via BEYIN_LANG. */
+const LANG = /^en/i.test(process.env.BEYIN_LANG || "") ? "en" : "tr";
 
 // Latest session context, needed to use pi's auth API (without touching auth.json directly).
 let latestContext: ExtensionContext | undefined;
@@ -279,7 +281,7 @@ export default function beyinJev(pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("jev-test", {
-		description: "CommandCode destekli Jev (typesafe/jev) classifier'ını dene",
+		description: LANG === "en" ? "Try the CommandCode-backed Jev (typesafe/jev) classifier" : "CommandCode destekli Jev (typesafe/jev) classifier'ını dene",
 		handler: async (args, ctx: ExtensionContext) => {
 			const model = ctx.modelRegistry.findOfType("classifier", PROVIDER, MODEL_ID);
 			if (!model) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-beyin",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "pi-native bridge for the beyin second brain: context injection, distillation reminders, and Jev advisor tools.",
   "keywords": [
     "pi-package",

package/skills/brain/SKILL.md

@@ -70,7 +70,7 @@ your behalf.
 
 ## Turning results into permanent knowledge
 
-The active agent continues V2's concept and link production. If a result contains reusable knowledge, first read
+The active agent produces the concept and link notes. If a result contains reusable knowledge, first read
 `knowledge/index.md` and only the relevant concept. Improve the existing note with its sources, or create
 `knowledge/concepts/<topic>.md`: short description, key points, reasoning/limits and sources. If the source is
 the user's own statement, say so explicitly. If two topics have a real relationship, create a reasoned connection