@astrosheep/pi-context 0.26.0 → 0.26.2

package/README.md

@@ -109,9 +109,9 @@ const matches = await notes.search(["library"]);
 
 `list` and `search` share the `NotesQuery` type. A merged query uses `{ pattern? }`; a single-home query adds `scope`. Only `scope: "agent" | "model"` accepts `who`. TypeScript rejects combinations such as `{ scope: "project", who: "root" }`, and JavaScript callers receive a runtime refusal.
 
-The library returns full data, not tool envelopes or paginated/truncated output. `NoteError` exposes the existing named store refusals through `code`, with `lineNumbers` for ambiguous edits and `editIndex` for a failed edit. Runtime API fields and known persisted note metadata use camelCase; Pi tool wire fields such as `updated_at`, `offset_chars`, and `replace_all` retain their established names. A note carrying a known legacy snake_case metadata key is refused with an explicit manual-migration-required error; import and construction never migrate note data. Invalid addresses/identities and filesystem failures reject; only a missing `read` returns `undefined`. Notes remain markdown files with the existing size limits and same-directory atomic rename. Same-file read/modify/write work is serialized by absolute physical filename across all store instances in this process (including `.md` address aliases); symlink/case aliases and cross-process locking are not guaranteed. `list` and `search` asynchronously traverse homes and serialize each discovered file read against pending mutations, but are not global snapshots and may not discover a file created after traversal. Foreign named homes can be read (including the access-metadata update), but their bodies cannot be written or edited through the store. These are cooperative address rules, not an OS security sandbox.
+The library returns full data, not tool envelopes or paginated/truncated output. `NoteError` exposes the existing named store refusals through `code`, with `lineNumbers` for ambiguous edits and `editIndex` for a failed edit. Runtime API fields and known persisted note metadata use camelCase; Pi tool wire fields such as `updated_at`, `offset_chars`, and `replace_all` retain their established names. Unrecognized frontmatter keys, including old snake_case metadata, are preserved as ordinary extras; they are not interpreted as current camelCase fields or migrated automatically. Invalid addresses/identities and filesystem failures reject; only a missing `read` returns `undefined`. Notes remain markdown files with the existing size limits and same-directory atomic rename. Same-file read/modify/write work is serialized by absolute physical filename across all store instances in this process (including `.md` address aliases); symlink/case aliases and cross-process locking are not guaranteed. `list` and `search` asynchronously traverse homes and serialize each discovered file read against pending mutations, but are not global snapshots and may not discover a file created after traversal. Foreign named homes can be read (including the access-metadata update), but their bodies cannot be written or edited through the store. These are cooperative address rules, not an OS security sandbox.
 
-Addresses use bare paths, `@project/`, `@human/`, `@self/`, `@model/`, or explicit `@agents/<slug>/` and `@models/<slug>/`. Relative self/model addresses resolve to the supplied identity; listing renders their concrete names. The disk layout remains `pi/session/<sessionId>/`, `project/<projectKey>/`, `human/`, `agents/<agent>/`, and `models/<model>/`. No data migration happens on library import or construction. Notes already using camelCase metadata retain their metadata; known legacy snake_case keys require the root-coordinated manual migration before use. New session notes record the supplied project key.
+Addresses use bare paths, `@project/`, `@human/`, `@self/`, `@model/`, or explicit `@agents/<slug>/` and `@models/<slug>/`. Relative self/model addresses resolve to the supplied identity; listing renders their concrete names. The disk layout remains `pi/session/<sessionId>/`, `project/<projectKey>/`, `human/`, `agents/<agent>/`, and `models/<model>/`. No data migration happens on library import or construction. Notes already using camelCase metadata retain their metadata; old snake_case keys are preserved as unrecognized extras, not interpreted or migrated. New session notes record the supplied project key.
 
 ### Library and plugin boundary
 

package/dist/build-info.json

@@ -1,4 +1,4 @@
 {
-  "version": "0.26.0",
-  "sourceHash": "48dcba30fd66f729c046d9ec89214e69ada06592df8d464f3b8cc70562dd5174"
+  "version": "0.26.2",
+  "sourceHash": "b35cc5826ee3ac651b5a18c57833aab912a9ee999af2c2dfc7f8672b74e31f81"
 }

package/dist/extension.js

@@ -1,5 +1,5 @@
 // <define:__PI_CONTEXT_BUILD__>
-var define_PI_CONTEXT_BUILD_default = { version: "0.26.0", sourceHash: "48dcba30fd66f729c046d9ec89214e69ada06592df8d464f3b8cc70562dd5174" };
+var define_PI_CONTEXT_BUILD_default = { version: "0.26.2", sourceHash: "b35cc5826ee3ac651b5a18c57833aab912a9ee999af2c2dfc7f8672b74e31f81" };
 
 // src/index.ts
 import { VERSION as VERSION2 } from "@earendil-works/pi-coding-agent";
@@ -8,6 +8,17 @@ import { VERSION as VERSION2 } from "@earendil-works/pi-coding-agent";
 import { Type as Type2 } from "@earendil-works/pi-ai";
 import { defineTool } from "@earendil-works/pi-coding-agent";
 
+// src/text-match.ts
+function earliestMatchOffsetChars(text, queries) {
+  let earliest = -1;
+  for (const query of queries) {
+    const index = text.indexOf(query);
+    if (index < 0) continue;
+    if (earliest < 0 || index < earliest) earliest = index;
+  }
+  return earliest <= 0 ? 0 : Array.from(text.slice(0, earliest)).length;
+}
+
 // src/tool-output.ts
 var TOOL_OUTPUT_MAX_BYTES = 32 * 1024;
 var DEFAULT_READ_WINDOW_CHARS = 12e3;
@@ -76,15 +87,6 @@ chars: [${window.offset_chars},${end}) of ${window.total_chars}
 next_offset_chars: ${next}
 `;
 }
-function earliestMatchOffsetChars(text, queries) {
-  let earliest = -1;
-  for (const query of queries) {
-    const index = text.indexOf(query);
-    if (index < 0) continue;
-    if (earliest < 0 || index < earliest) earliest = index;
-  }
-  return earliest <= 0 ? 0 : Array.from(text.slice(0, earliest)).length;
-}
 function page(items, cursor2, key, limit, truncate) {
   const end = Math.min(items.length, cursor2 + (limit ?? items.length));
   const selected = [];
@@ -247,10 +249,10 @@ var WARNING_TYPE = "pi-context/warning";
 var RESET_MARKER_TYPE = "pi-context/reset-marker";
 var CONTINUATION_TYPE = "pi-context/continuation";
 var POCKET_SESSION_LIMIT = 5;
-var POCKET_PROJECT_LIMIT = 2;
-var POCKET_HUMAN_LIMIT = 2;
-var POCKET_AGENT_LIMIT = 1;
-var POCKET_MODEL_LIMIT = 1;
+var POCKET_PROJECT_LIMIT = 5;
+var POCKET_HUMAN_LIMIT = 5;
+var POCKET_AGENT_LIMIT = 5;
+var POCKET_MODEL_LIMIT = 3;
 var CONTEXT_WINDOW_OPEN_TAG = "<context_window>";
 var CONTEXT_WINDOW_CLOSE_TAG = "</context_window>";
 var CONTEXT_WINDOW_PROTOCOL_OPEN_TAG = "<context_window_protocol>";
@@ -592,7 +594,6 @@ var SCOPES = ["session", "project", "human", "agent", "model"];
 var ORIGINS = ["user", "self", "external"];
 var STATUSES = ["active", "superseded", "pending", "archived"];
 var TIMESTAMP_KEYS = ["createdAt", "updatedAt", "lastAccessed"];
-var LEGACY_KNOWN_KEYS = ["created_at", "updated_at", "last_accessed", "access_count", "source_window", "recurrence_count", "recurrence_windows"];
 var KNOWN_KEYS = ["origin", "status", "stale", "createdAt", "updatedAt", "lastAccessed", "accessCount", "sourceWindow", "supersedes", "recurrenceCount", "recurrenceWindows"];
 var pad2 = (value) => String(value).padStart(2, "0");
 function localIso(epochMs) {
@@ -666,8 +667,6 @@ function parseFrontmatter(raw) {
 }
 function parseNote(raw, now = Date.now()) {
   const { fields, body } = parseFrontmatter(raw);
-  const legacyKeys = LEGACY_KNOWN_KEYS.filter((key) => Object.hasOwn(fields, key));
-  if (legacyKeys.length > 0) throw new Error(`legacy note metadata ${legacyKeys.join(", ")} requires manual migration to camelCase before this note can be used`);
   const meta = { ...fields };
   meta.scope = isScope(meta.scope) ? meta.scope : "session";
   meta.origin = isOrigin(meta.origin) ? meta.origin : "self";
@@ -1003,15 +1002,6 @@ function matchLineNumbers(body, needle) {
   }
   return lines;
 }
-function earliestMatchOffsetChars2(text, queries) {
-  let earliest = -1;
-  for (const query of queries) {
-    const index = text.indexOf(query);
-    if (index < 0) continue;
-    if (earliest < 0 || index < earliest) earliest = index;
-  }
-  return earliest <= 0 ? 0 : Array.from(text.slice(0, earliest)).length;
-}
 async function atomicWrite(path, content) {
   await mkdir(dirname2(path), { recursive: true });
   const tmp = `${path}.${process.pid}.${randomUUID()}.tmp`;
@@ -1156,11 +1146,10 @@ function createNotesStore(input) {
       return { meta, applied: operations.length, resolvedScope: scope, change };
     });
   }
-  async function list(options = {}) {
-    const stableOptions = { ...options };
-    const matcher = matcherFor(normalizePattern(stableOptions.pattern, context));
-    const rows = [];
-    for (const home of await homesFor(context, stableOptions)) {
+  async function* scan(options) {
+    const matcher = matcherFor(normalizePattern(options.pattern, context));
+    const homes = await homesFor(context, options);
+    for (const home of homes) {
       const scope = home.scope;
       const root = scopeDir(scope, context, home.who);
       for (const path of await walkMarkdown(root)) {
@@ -1170,38 +1159,35 @@ function createNotesStore(input) {
         const raw = await withPathQueue(fullPath, () => readFile(fullPath, "utf8"));
         const { meta, body } = parseNote(raw);
         meta.scope = scope;
-        rows.push({ address, scope, path, meta, body, sizeBytes: Buffer.byteLength(body, "utf8") });
+        yield { address, scope, path, meta, body };
       }
     }
+  }
+  async function list(options = {}) {
+    const stableOptions = { ...options };
+    const rows = [];
+    for await (const row of scan(stableOptions)) {
+      rows.push({ ...row, sizeBytes: Buffer.byteLength(row.body, "utf8") });
+    }
     rows.sort((a, b) => b.meta.updatedAt - a.meta.updatedAt || a.address.localeCompare(b.address));
     return rows;
   }
   async function search(queries, options = {}) {
     const stableQueries = [...queries];
     const stableOptions = { ...options };
-    const matcher = matcherFor(normalizePattern(stableOptions.pattern, context));
     const rows = [];
-    for (const home of await homesFor(context, stableOptions)) {
-      const scope = home.scope;
-      const root = scopeDir(scope, context, home.who);
-      for (const path of await walkMarkdown(root)) {
-        const address = addressFor(context, scope, path, home.who);
-        if (matcher && !matcher.test(address)) continue;
-        const fullPath = join2(root, path);
-        const raw = await withPathQueue(fullPath, () => readFile(fullPath, "utf8"));
-        const { meta, body } = parseNote(raw);
-        meta.scope = scope;
-        const serializedBodyOffset = Array.from(serializeNote(accessedMeta(meta, scope, Date.now()), "")).length;
-        let baseChars = 0;
-        const matches = [];
-        for (const [index, line] of body.split("\n").entries()) {
-          if (stableQueries.some((query) => line.includes(query))) {
-            matches.push({ line: index + 1, text: line, offsetChars: serializedBodyOffset + baseChars + earliestMatchOffsetChars2(line, stableQueries) });
-          }
-          baseChars += Array.from(line).length + 1;
+    for await (const note of scan(stableOptions)) {
+      const { address, path, scope, meta, body } = note;
+      const serializedBodyOffset = Array.from(serializeNote(accessedMeta(meta, scope, Date.now()), "")).length;
+      let baseChars = 0;
+      const matches = [];
+      for (const [index, line] of body.split("\n").entries()) {
+        if (stableQueries.some((query) => line.includes(query))) {
+          matches.push({ line: index + 1, text: line, offsetChars: serializedBodyOffset + baseChars + earliestMatchOffsetChars(line, stableQueries) });
         }
-        if (matches.length > 0) rows.push({ address, path, scope, meta, matches });
+        baseChars += Array.from(line).length + 1;
       }
+      if (matches.length > 0) rows.push({ address, path, scope, meta, matches });
     }
     rows.sort((a, b) => a.address.localeCompare(b.address));
     return rows;
@@ -1494,7 +1480,7 @@ function notesIndex(snapshot) {
   if (recentNotes.length > 0) {
     const lines = [`You find ${recentNotes.length} crumpled note${recentNotes.length === 1 ? "" : "s"} in your pocket (by prefix, most recent first within each: up to ${POCKET_SESSION_LIMIT} from this session, ${POCKET_PROJECT_LIMIT} from @project, ${POCKET_HUMAN_LIMIT} from @human, ${POCKET_AGENT_LIMIT} from @self, ${POCKET_MODEL_LIMIT} from @model). A note's content never appears here, so its name has to say what the note is about:`];
     for (const row of recentNotes) {
-      lines.push(`- ${row.address} (${row.body.split("\n").length} lines, ${row.sizeBytes} UTF-8 bytes, updated ${relativeTime(row.meta.updatedAt, snapshot.openedAt)})`);
+      lines.push(`- ${row.address}  \xB7  ${Array.from(row.body).length} chars  \xB7  ${relativeTime(row.meta.updatedAt, snapshot.openedAt)}`);
     }
     sections.push(lines.join("\n"));
   }
@@ -1556,14 +1542,29 @@ function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () => {
   };
   let pendingGuidance;
   let pendingWarning;
-  let pendingNotices = [];
-  const notifyCommittedReminders = (ctx) => {
-    const windowId = currentWindowId(ctx);
-    for (const notice of pendingNotices) {
-      if (notice.windowId !== windowId || !hasWindowMessage(ctx, notice.customType)) continue;
-      ctx.ui.notify(notice.customType === WARNING_TYPE ? "pi-context: Context almost full; close out the current memory window." : "pi-context: Context running low; checkpoint your notes soon.", "warning");
+  let pendingNotices = /* @__PURE__ */ new Map();
+  const noticeKey = (sessionId, windowId) => `${sessionId}:${windowId}`;
+  const warningCommittedInWindow = (ctx, notice) => {
+    if (ctx.sessionManager.getSessionId() !== notice.sessionId) return false;
+    let windowId = rootWindowId(notice.sessionId);
+    for (const entry of ctx.sessionManager.getBranch()) {
+      if (isWindowMarker(entry)) {
+        windowId = entry.data.windowId;
+        continue;
+      }
+      if (windowId === notice.windowId && entry.type === "custom_message" && entry.customType === WARNING_TYPE) return true;
+    }
+    return false;
+  };
+  const notifyCommittedWarnings = (ctx, settled = false) => {
+    for (const [key, notice] of pendingNotices) {
+      if (warningCommittedInWindow(ctx, notice)) {
+        pendingNotices.delete(key);
+        ctx.ui.notify("pi-context: Context almost full; close out the current memory window.", "warning");
+      } else if (settled) {
+        pendingNotices.delete(key);
+      }
     }
-    pendingNotices = [];
   };
   const clearStaged = () => {
     pendingGuidance = void 0;
@@ -1571,7 +1572,7 @@ function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () => {
   };
   const resetForTransition = () => {
     clearStaged();
-    pendingNotices = [];
+    pendingNotices.clear();
     invalidateThresholds();
     notifiedWarnings.clear();
   };
@@ -1583,7 +1584,10 @@ function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () => {
     clearStaged();
     const windowId = currentWindowId(ctx);
     const drafts = staged.filter((draft) => draft !== void 0 && draft.windowId === windowId);
-    pendingNotices = drafts.map(({ windowId: windowId2, customType, remaining }) => ({ windowId: windowId2, customType, remaining }));
+    if (drafts.some((draft) => draft.customType === WARNING_TYPE)) {
+      const sessionId = ctx.sessionManager.getSessionId();
+      pendingNotices.set(noticeKey(sessionId, windowId), { sessionId, windowId });
+    }
     return drafts.map((draft) => ({
       type: "custom_message",
       customType: draft.customType,
@@ -1598,8 +1602,9 @@ function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () => {
   pi.on("session_tree", resetForTransition);
   pi.on("model_select", resetForTransition);
   pi.on("session_shutdown", resetForTransition);
+  pi.on("turn_start", (_event, ctx) => notifyCommittedWarnings(ctx));
   pi.on("agent_settled", (_event, ctx) => {
-    notifyCommittedReminders(ctx);
+    notifyCommittedWarnings(ctx, true);
     clearStaged();
   });
   pi.on("context", (_event, ctx) => {
@@ -1647,7 +1652,7 @@ function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () => {
     consumeTurnEnd,
     clear: () => {
       clearStaged();
-      pendingNotices = [];
+      pendingNotices.clear();
     }
   };
 }

package/dist/src/context/budget.js

@@ -2,7 +2,7 @@ import { Type } from "@earendil-works/pi-ai";
 import { defineTool } from "@earendil-works/pi-coding-agent";
 import { GUIDANCE_TYPE, WARNING_CONTENT, WARNING_TYPE } from "../protocol.js";
 import { readThresholdSettings } from "./thresholds.js";
-import { currentWindowId, hasWindowMessage, windowUsage } from "./context-window.js";
+import { currentWindowId, hasWindowMessage, isWindowMarker, rootWindowId, windowUsage } from "./context-window.js";
 import { tokenBudgetGuidance } from "./prompts.js";
 import { output } from "../tool-output.js";
 /** Remaining tokens in the provider's active window, or null without a usable estimate. */
@@ -42,17 +42,33 @@ export function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () =
     const invalidateThresholds = () => { cachedPolicy = undefined; };
     let pendingGuidance;
     let pendingWarning;
-    let pendingNotices = [];
-    const notifyCommittedReminders = (ctx) => {
-        const windowId = currentWindowId(ctx);
-        for (const notice of pendingNotices) {
-            if (notice.windowId !== windowId || !hasWindowMessage(ctx, notice.customType))
+    let pendingNotices = new Map();
+    const noticeKey = (sessionId, windowId) => `${sessionId}:${windowId}`;
+    const warningCommittedInWindow = (ctx, notice) => {
+        if (ctx.sessionManager.getSessionId() !== notice.sessionId)
+            return false;
+        let windowId = rootWindowId(notice.sessionId);
+        for (const entry of ctx.sessionManager.getBranch()) {
+            if (isWindowMarker(entry)) {
+                windowId = entry.data.windowId;
                 continue;
-            ctx.ui.notify(notice.customType === WARNING_TYPE
-                ? "pi-context: Context almost full; close out the current memory window."
-                : "pi-context: Context running low; checkpoint your notes soon.", "warning");
+            }
+            if (windowId === notice.windowId && entry.type === "custom_message" && entry.customType === WARNING_TYPE)
+                return true;
+        }
+        return false;
+    };
+    const notifyCommittedWarnings = (ctx, settled = false) => {
+        for (const [key, notice] of pendingNotices) {
+            if (warningCommittedInWindow(ctx, notice)) {
+                pendingNotices.delete(key);
+                ctx.ui.notify("pi-context: Context almost full; close out the current memory window.", "warning");
+            }
+            else if (settled) {
+                // An uncommitted draft must not be matched to a later manual warning.
+                pendingNotices.delete(key);
+            }
         }
-        pendingNotices = [];
     };
     const clearStaged = () => {
         pendingGuidance = undefined;
@@ -60,7 +76,7 @@ export function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () =
     };
     const resetForTransition = () => {
         clearStaged();
-        pendingNotices = [];
+        pendingNotices.clear();
         invalidateThresholds();
         notifiedWarnings.clear();
     };
@@ -72,7 +88,10 @@ export function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () =
         clearStaged();
         const windowId = currentWindowId(ctx);
         const drafts = staged.filter((draft) => draft !== undefined && draft.windowId === windowId);
-        pendingNotices = drafts.map(({ windowId, customType, remaining }) => ({ windowId, customType, remaining }));
+        if (drafts.some((draft) => draft.customType === WARNING_TYPE)) {
+            const sessionId = ctx.sessionManager.getSessionId();
+            pendingNotices.set(noticeKey(sessionId, windowId), { sessionId, windowId });
+        }
         return drafts.map((draft) => ({
             type: "custom_message",
             customType: draft.customType,
@@ -84,12 +103,12 @@ export function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () =
     pi.on("session_tree", resetForTransition);
     pi.on("model_select", resetForTransition);
     pi.on("session_shutdown", resetForTransition);
-    // A request can fail before Pi emits turn_end. agent_settled is the public
-    // lifecycle point that must discard an uncommitted draft before the next prompt.
-    // UI notices follow committed reminders. Aborted requests can retry their drafts
-    // without showing the same low-budget notification twice.
+    // A warning can be committed at turn_end, before a tool turn or a reset changes the
+    // active window. Observe the active branch at public lifecycle boundaries and match
+    // the candidate against its originating window segment, not only the current window.
+    pi.on("turn_start", (_event, ctx) => notifyCommittedWarnings(ctx));
     pi.on("agent_settled", (_event, ctx) => {
-        notifyCommittedReminders(ctx);
+        notifyCommittedWarnings(ctx, true);
         clearStaged();
     });
     pi.on("context", (_event, ctx) => {
@@ -149,6 +168,6 @@ export function registerBudget(pi, isEnabled, settingsManager, onCloseOut = () =
         automaticResetEnabled,
         hardReserveDue,
         consumeTurnEnd,
-        clear: () => { clearStaged(); pendingNotices = []; },
+        clear: () => { clearStaged(); pendingNotices.clear(); },
     };
 }

package/dist/src/context/prompts.js

@@ -32,8 +32,8 @@ function notesUnavailableNotice(snapshot) {
  * per home, and the session home is never peeked — a session MAP.md is an ordinary note. The
  * pocket then lists recent fresh notes under per-home quotas (POCKET_SESSION_LIMIT /
  * POCKET_PROJECT_LIMIT / POCKET_HUMAN_LIMIT / POCKET_AGENT_LIMIT / POCKET_MODEL_LIMIT),
- * most-recently-updated first within each home, one metadata line each: address, line count,
- * UTF-8 byte count, relative update time at window open. Bodies never render
+ * most-recently-updated first within each home, one metadata line each: address, body character
+ * count, relative update time at window open. Bodies never render
  * in the pocket; stale notes are excluded; MAP.md itself never takes a pocket seat.
  */
 function notesIndex(snapshot) {
@@ -59,7 +59,7 @@ function notesIndex(snapshot) {
     if (recentNotes.length > 0) {
         const lines = [`You find ${recentNotes.length} crumpled note${recentNotes.length === 1 ? "" : "s"} in your pocket (by prefix, most recent first within each: up to ${POCKET_SESSION_LIMIT} from this session, ${POCKET_PROJECT_LIMIT} from @project, ${POCKET_HUMAN_LIMIT} from @human, ${POCKET_AGENT_LIMIT} from @self, ${POCKET_MODEL_LIMIT} from @model). A note's content never appears here, so its name has to say what the note is about:`];
         for (const row of recentNotes) {
-            lines.push(`- ${row.address} (${row.body.split("\n").length} lines, ${row.sizeBytes} UTF-8 bytes, updated ${relativeTime(row.meta.updatedAt, snapshot.openedAt)})`);
+            lines.push(`- ${row.address}  ·  ${Array.from(row.body).length} chars  ·  ${relativeTime(row.meta.updatedAt, snapshot.openedAt)}`);
         }
         sections.push(lines.join("\n"));
     }

package/dist/src/dream/doctor.js

@@ -41,10 +41,6 @@ export function doctor(home) {
             if (!valid.test(fields.get(key) ?? ""))
                 report(path, `missing/invalid ${key}; repair frontmatter`);
         }
-        for (const [legacy, current] of [["created_at", "createdAt"], ["updated_at", "updatedAt"], ["last_accessed", "lastAccessed"], ["access_count", "accessCount"], ["source_window", "sourceWindow"], ["recurrence_count", "recurrenceCount"], ["recurrence_windows", "recurrenceWindows"]]) {
-            if (fields.has(legacy))
-                report(path, `legacy metadata key ${legacy}; manually migrate to ${current}`);
-        }
         for (const key of ["createdAt", "updatedAt", "lastAccessed"]) {
             const value = fields.get(key);
             if (!value || !Number.isFinite(Date.parse(value)))

package/dist/src/notes/frontmatter.d.ts

@@ -33,8 +33,7 @@ export declare function isScope(value: unknown): value is Scope;
 export declare function isOrigin(value: unknown): value is Origin;
 /**
  * Parse a note file. Missing known keys take the Design defaults (status active, stale false,
- * accessCount 0, timestamps now); unknown keys are carried through untouched. Known
- * snake_case metadata is refused because it requires the explicit manual migration.
+ * accessCount 0, timestamps now); unknown keys are carried through untouched.
  */
 export declare function parseNote(raw: string, now?: number): {
     meta: NoteMeta;

package/dist/src/notes/frontmatter.js

@@ -2,7 +2,6 @@ const SCOPES = ["session", "project", "human", "agent", "model"];
 const ORIGINS = ["user", "self", "external"];
 const STATUSES = ["active", "superseded", "pending", "archived"];
 const TIMESTAMP_KEYS = ["createdAt", "updatedAt", "lastAccessed"];
-const LEGACY_KNOWN_KEYS = ["created_at", "updated_at", "last_accessed", "access_count", "source_window", "recurrence_count", "recurrence_windows"];
 /** Emission order, exactly the Design's key list. */
 const KNOWN_KEYS = ["origin", "status", "stale", "createdAt", "updatedAt", "lastAccessed", "accessCount", "sourceWindow", "supersedes", "recurrenceCount", "recurrenceWindows"];
 const pad2 = (value) => String(value).padStart(2, "0");
@@ -98,14 +97,10 @@ function parseFrontmatter(raw) {
 }
 /**
  * Parse a note file. Missing known keys take the Design defaults (status active, stale false,
- * accessCount 0, timestamps now); unknown keys are carried through untouched. Known
- * snake_case metadata is refused because it requires the explicit manual migration.
+ * accessCount 0, timestamps now); unknown keys are carried through untouched.
  */
 export function parseNote(raw, now = Date.now()) {
     const { fields, body } = parseFrontmatter(raw);
-    const legacyKeys = LEGACY_KNOWN_KEYS.filter((key) => Object.hasOwn(fields, key));
-    if (legacyKeys.length > 0)
-        throw new Error(`legacy note metadata ${legacyKeys.join(", ")} requires manual migration to camelCase before this note can be used`);
     const meta = { ...fields };
     // scope is a legacy on-disk field: store callers derive it from the file's home and
     // overwrite it after parsing, so an absent or outdated value just falls back.

package/dist/src/notes/store.js

@@ -1,6 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { mkdir, readdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
+import { earliestMatchOffsetChars } from "../text-match.js";
 import { assertAddress, assertGlobPattern, addressFor, globToRegExp } from "./address.js";
 import { snapshotNotesContext } from "./context.js";
 import { MAX_NOTE_BYTES, MAX_NOTE_PATH_BYTES } from "./constants.js";
@@ -149,18 +150,6 @@ function matchLineNumbers(body, needle) {
     }
     return lines;
 }
-/** Code-point offset of the earliest query occurrence, matching the serialized read text. */
-function earliestMatchOffsetChars(text, queries) {
-    let earliest = -1;
-    for (const query of queries) {
-        const index = text.indexOf(query);
-        if (index < 0)
-            continue;
-        if (earliest < 0 || index < earliest)
-            earliest = index;
-    }
-    return earliest <= 0 ? 0 : Array.from(text.slice(0, earliest)).length;
-}
 /** Every mutation uses a tmp file renamed into place in the same directory. */
 async function atomicWrite(path, content) {
     await mkdir(dirname(path), { recursive: true });
@@ -329,11 +318,10 @@ export function createNotesStore(input) {
             return { meta, applied: operations.length, resolvedScope: scope, change };
         });
     }
-    async function list(options = {}) {
-        const stableOptions = { ...options };
-        const matcher = matcherFor(normalizePattern(stableOptions.pattern, context));
-        const rows = [];
-        for (const home of await homesFor(context, stableOptions)) {
+    async function* scan(options) {
+        const matcher = matcherFor(normalizePattern(options.pattern, context));
+        const homes = await homesFor(context, options);
+        for (const home of homes) {
             const scope = home.scope;
             const root = scopeDir(scope, context, home.who);
             for (const path of await walkMarkdown(root)) {
@@ -344,40 +332,36 @@ export function createNotesStore(input) {
                 const raw = await withPathQueue(fullPath, () => readFile(fullPath, "utf8"));
                 const { meta, body } = parseNote(raw);
                 meta.scope = scope;
-                rows.push({ address, scope, path, meta, body, sizeBytes: Buffer.byteLength(body, "utf8") });
+                yield { address, scope, path, meta, body };
             }
         }
+    }
+    async function list(options = {}) {
+        const stableOptions = { ...options };
+        const rows = [];
+        for await (const row of scan(stableOptions)) {
+            rows.push({ ...row, sizeBytes: Buffer.byteLength(row.body, "utf8") });
+        }
         rows.sort((a, b) => b.meta.updatedAt - a.meta.updatedAt || a.address.localeCompare(b.address));
         return rows;
     }
     async function search(queries, options = {}) {
         const stableQueries = [...queries];
         const stableOptions = { ...options };
-        const matcher = matcherFor(normalizePattern(stableOptions.pattern, context));
         const rows = [];
-        for (const home of await homesFor(context, stableOptions)) {
-            const scope = home.scope;
-            const root = scopeDir(scope, context, home.who);
-            for (const path of await walkMarkdown(root)) {
-                const address = addressFor(context, scope, path, home.who);
-                if (matcher && !matcher.test(address))
-                    continue;
-                const fullPath = join(root, path);
-                const raw = await withPathQueue(fullPath, () => readFile(fullPath, "utf8"));
-                const { meta, body } = parseNote(raw);
-                meta.scope = scope;
-                const serializedBodyOffset = Array.from(serializeNote(accessedMeta(meta, scope, Date.now()), "")).length;
-                let baseChars = 0;
-                const matches = [];
-                for (const [index, line] of body.split("\n").entries()) {
-                    if (stableQueries.some((query) => line.includes(query))) {
-                        matches.push({ line: index + 1, text: line, offsetChars: serializedBodyOffset + baseChars + earliestMatchOffsetChars(line, stableQueries) });
-                    }
-                    baseChars += Array.from(line).length + 1;
+        for await (const note of scan(stableOptions)) {
+            const { address, path, scope, meta, body } = note;
+            const serializedBodyOffset = Array.from(serializeNote(accessedMeta(meta, scope, Date.now()), "")).length;
+            let baseChars = 0;
+            const matches = [];
+            for (const [index, line] of body.split("\n").entries()) {
+                if (stableQueries.some((query) => line.includes(query))) {
+                    matches.push({ line: index + 1, text: line, offsetChars: serializedBodyOffset + baseChars + earliestMatchOffsetChars(line, stableQueries) });
                 }
-                if (matches.length > 0)
-                    rows.push({ address, path, scope, meta, matches });
+                baseChars += Array.from(line).length + 1;
             }
+            if (matches.length > 0)
+                rows.push({ address, path, scope, meta, matches });
         }
         rows.sort((a, b) => a.address.localeCompare(b.address));
         return rows;

package/dist/src/protocol.d.ts

@@ -6,10 +6,10 @@ export declare const RESET_MARKER_TYPE = "pi-context/reset-marker";
 export declare const CONTINUATION_TYPE = "pi-context/continuation";
 export { MAX_NOTE_BYTES, MAX_NOTE_PATH_BYTES } from "./notes/constants.js";
 export declare const POCKET_SESSION_LIMIT = 5;
-export declare const POCKET_PROJECT_LIMIT = 2;
-export declare const POCKET_HUMAN_LIMIT = 2;
-export declare const POCKET_AGENT_LIMIT = 1;
-export declare const POCKET_MODEL_LIMIT = 1;
+export declare const POCKET_PROJECT_LIMIT = 5;
+export declare const POCKET_HUMAN_LIMIT = 5;
+export declare const POCKET_AGENT_LIMIT = 5;
+export declare const POCKET_MODEL_LIMIT = 3;
 export declare const CONTEXT_WINDOW_OPEN_TAG = "<context_window>";
 export declare const CONTEXT_WINDOW_CLOSE_TAG = "</context_window>";
 export declare const CONTEXT_WINDOW_PROTOCOL_OPEN_TAG = "<context_window_protocol>";

package/dist/src/protocol.js

@@ -6,10 +6,10 @@ export const RESET_MARKER_TYPE = "pi-context/reset-marker";
 export const CONTINUATION_TYPE = "pi-context/continuation";
 export { MAX_NOTE_BYTES, MAX_NOTE_PATH_BYTES } from "./notes/constants.js";
 export const POCKET_SESSION_LIMIT = 5;
-export const POCKET_PROJECT_LIMIT = 2;
-export const POCKET_HUMAN_LIMIT = 2;
-export const POCKET_AGENT_LIMIT = 1;
-export const POCKET_MODEL_LIMIT = 1;
+export const POCKET_PROJECT_LIMIT = 5;
+export const POCKET_HUMAN_LIMIT = 5;
+export const POCKET_AGENT_LIMIT = 5;
+export const POCKET_MODEL_LIMIT = 3;
 export const CONTEXT_WINDOW_OPEN_TAG = "<context_window>";
 export const CONTEXT_WINDOW_CLOSE_TAG = "</context_window>";
 export const CONTEXT_WINDOW_PROTOCOL_OPEN_TAG = "<context_window_protocol>";

package/dist/src/text-match.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Code-point offset of the earliest occurrence of any of `queries` in `text`, or 0 when
+ * none occurs. Shared by the two search tools so a match address is computed identically.
+ */
+export declare function earliestMatchOffsetChars(text: string, queries: string[]): number;

package/dist/src/text-match.js

@@ -0,0 +1,15 @@
+/**
+ * Code-point offset of the earliest occurrence of any of `queries` in `text`, or 0 when
+ * none occurs. Shared by the two search tools so a match address is computed identically.
+ */
+export function earliestMatchOffsetChars(text, queries) {
+    let earliest = -1;
+    for (const query of queries) {
+        const index = text.indexOf(query);
+        if (index < 0)
+            continue;
+        if (earliest < 0 || index < earliest)
+            earliest = index;
+    }
+    return earliest <= 0 ? 0 : Array.from(text.slice(0, earliest)).length;
+}

package/dist/src/tool-output.d.ts

@@ -1,3 +1,4 @@
+export { earliestMatchOffsetChars } from "./text-match.js";
 export declare const TOOL_OUTPUT_MAX_BYTES: number;
 export declare const DEFAULT_READ_WINDOW_CHARS = 12000;
 export declare const MAX_READ_WINDOW_CHARS = 50000;
@@ -55,11 +56,6 @@ export declare function readCharacterWindow<T>(text: string, offsetChars: number
  * source identity fields in wire order; range and continuation semantics are shared.
  */
 export declare function readWindowBlock(identity: ReadonlyArray<readonly [string, string]>, window: CharacterWindow): string;
-/**
- * Code-point offset of the earliest occurrence of any of `queries` in `text`, or 0 when
- * none occurs. Shared by the two search tools so a match address is computed identically.
- */
-export declare function earliestMatchOffsetChars(text: string, queries: string[]): number;
 /** Shrink a single page item to fit; only invoked when that item alone exceeds the budget. */
 export type ItemTruncator<T> = (item: T, fits: (candidate: T) => boolean) => T;
 /**