memgineering 0.23.0 → 0.23.1

package/CHANGELOG.md

@@ -11,6 +11,32 @@ language the reader wants. The bilingual rule the monorepo applies to
 
 ## [Unreleased]
 
+## [0.23.1] — 2026-09-11
+
+### Fixed
+
+- **The rules a hook shows now include the sentence that says what to do.**
+  `memgineering guard` quoted each rule's `summary`, which is the note's text
+  cut at 200 characters — so a rule long enough to describe a problem before
+  prescribing an answer arrived with the answer removed. Measured across 24
+  sessions: of six rules planted as global rules, five were cut immediately
+  before their prescription, and every session holding one of them walked into
+  the trap its own rule described. The hook now quotes the rule as written, and
+  when it still has to shorten one it elides the MIDDLE, keeping the opening and
+  the closing instruction.
+- **A short list of rules is now read further than a long one.** The width is a
+  budget shared across the whole block rather than a fixed cap per line, so two
+  standing decisions arrive in full where ten are abbreviated. Ten rules cost
+  exactly what ten rules cost before — nothing here prints more than it used to.
+
+### Added
+
+- **A hosted brain sends the rule, not just the card.** `POST /rules` gained a
+  `text` field carrying the rule as written; a client older than this ignores it
+  and keeps rendering `summary`, and a server older than this makes the new
+  client fall back to `summary` as well. Deploy the server first to get the
+  benefit; neither order breaks anything.
+
 ## [0.23.0] — 2026-09-09
 
 ### Added

package/assets/MEMGINEERING.md

@@ -2,7 +2,7 @@
 name: memgineering
 description: Use whenever the user refers to something they told you before, asks what was decided, tells you something worth keeping, or settles something that should hold next time. The memory lives in their own folder and outlives this session; check it before answering from guesswork, and write to it when you learn something durable.
 type: skill
-version: 0.23.0
+version: 0.23.1
 ---
 
 # memgineering

package/dist/index.js

@@ -497,6 +497,52 @@ var init_rule_budget = __esm({
   }
 });
 
+// ../../packages/memory-engine/src/rule-text.ts
+function ruleTextOf(entry) {
+  const intro = (entry.chunks ?? []).find((chunk) => chunk.label === null)?.text.trim();
+  if (intro !== void 0 && intro !== "") return intro;
+  return entry.memory.summary ?? entry.memory.title;
+}
+function ruleWidthFor(count) {
+  if (count <= 0) return RULE_WIDTH_MIN;
+  const share = Math.floor(RULE_BLOCK_BUDGET / count);
+  return Math.min(RULE_WIDTH_MAX, Math.max(RULE_WIDTH_MIN, share));
+}
+function rulePassage(text, max) {
+  const flat = text.replace(/\s+/g, " ").trim();
+  const chars = [...flat];
+  if (chars.length <= max) return flat;
+  if (max <= 1) return "\u2026";
+  const budget = max - 1;
+  if (budget < 2) return `${chars.slice(0, budget).join("")}\u2026`;
+  const tailBudget = Math.min(budget - 1, Math.max(1, Math.floor(budget * 0.6)));
+  const tail = [...trailingSentences(flat, tailBudget)];
+  const head = chars.slice(0, budget - tail.length).join("").trimEnd();
+  return `${head}\u2026${tail.join("")}`;
+}
+function trailingSentences(flat, budget) {
+  const starts = [...flat.matchAll(/[.!?。！？](?=\s)/g)].map(
+    (match) => match.index + match[0].length
+  );
+  let best = null;
+  for (let i = starts.length - 1; i >= 0; i -= 1) {
+    const candidate = flat.slice(starts[i]).trim();
+    if ([...candidate].length > budget) break;
+    if (candidate !== "") best = candidate;
+  }
+  if (best !== null) return best;
+  return [...flat].slice(-budget).join("");
+}
+var RULE_WIDTH_MIN, RULE_WIDTH_MAX, RULE_BLOCK_BUDGET;
+var init_rule_text = __esm({
+  "../../packages/memory-engine/src/rule-text.ts"() {
+    "use strict";
+    RULE_WIDTH_MIN = 200;
+    RULE_WIDTH_MAX = 600;
+    RULE_BLOCK_BUDGET = RULE_WIDTH_MIN * 10;
+  }
+});
+
 // ../../packages/memory-engine/src/boundary.ts
 function normalizeForMatch(value) {
   return value.normalize("NFC").replace(ZERO_WIDTH, "").replace(WHITESPACE_RUN, " ").trim();
@@ -4230,6 +4276,7 @@ var init_src = __esm({
     init_schema();
     init_layout();
     init_rule_budget();
+    init_rule_text();
     init_boundary();
     init_markdown_mapping();
     init_build();
@@ -15797,26 +15844,31 @@ async function collectRules(vault, contextDir, now = /* @__PURE__ */ new Date())
     ...unreachableDefault ? { unreachableDefault } : {}
   };
 }
-var RULE_WIDTH = 200;
+var RULE_WIDTH = RULE_WIDTH_MIN;
 function renderRuleLine(text, width = RULE_WIDTH) {
-  return quoteBlock(oneLine(text, width));
+  return quoteBlock(rulePassage(oneLineWhole(text), width));
 }
-function renderRuleLines(rules) {
-  return rules.map(({ entry }) => renderRuleLine(entry.memory.summary ?? entry.memory.title));
+function renderRuleLines(rules, width = ruleWidthFor(rules.length)) {
+  return rules.map(({ entry }) => renderRuleLine(ruleTextOf(entry), width));
 }
 function renderRuleGroups(rules, project) {
   const globals = rules.filter((rule) => rule.lane === "global");
   const scoped = rules.filter((rule) => rule.lane === "project");
+  const width = ruleWidthFor(rules.length);
   const out = [];
   if (globals.length > 0 && scoped.length > 0) {
-    out.push("Everywhere:", ...renderRuleLines(globals), "");
-    out.push(`In ${oneLine(project ?? "this project", WIDTH.title)}:`, ...renderRuleLines(scoped));
+    out.push("Everywhere:", ...renderRuleLines(globals, width), "");
+    out.push(
+      `In ${oneLine(project ?? "this project", WIDTH.title)}:`,
+      ...renderRuleLines(scoped, width)
+    );
     return out;
   }
-  return renderRuleLines(rules);
+  return renderRuleLines(rules, width);
 }
 
 // src/commands/guard.ts
+init_src();
 init_deadline();
 init_cloud_brain();
 function guardCommand() {
@@ -16015,7 +16067,8 @@ async function hostedRuleLines(where, contextDir) {
   return { lines: grouped, total };
 }
 function groupHostedLines(rules, project) {
-  const line = (r) => renderRuleLine(r.summary ?? r.title);
+  const width = ruleWidthFor(rules.length);
+  const line = (r) => renderRuleLine(r.text ?? r.summary ?? r.title, width);
   const globals = rules.filter((r) => r.lane === "global");
   const scoped = rules.filter((r) => r.lane === "project");
   if (globals.length === 0 || scoped.length === 0) return rules.map(line);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memgineering",
-  "version": "0.23.0",
+  "version": "0.23.1",
   "private": false,
   "description": "One memory for the AI you connect. Recall, remember, and revise a brain your agents share — stored in your own folder.",
   "license": "Apache-2.0",