@jwilger/pi-development-system 0.82.0 → 0.83.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jwilger/pi-development-system",
-  "version": "0.82.0",
+  "version": "0.83.0",
   "description": "A pi extension package representing a seasoned approach to software development using a full AI SDLC.",
   "keywords": [
     "pi-package"

package/src/subagents/VENDORED.md

@@ -41,3 +41,4 @@ SOFTWARE.
 6. Empty scope (I5 review): `orch/runtime.ts` `availableScopedModels` treats an empty `/scoped-models` as no restriction (pi's meaning) instead of "matches nothing", because every devsys agent declares `models:` and would otherwise be unspawnable by default. Pinned models are also re-applied on resume (`resolveInitialSettings`), since a restored session may hold only inherited history.
 7. Bundled agents outside `src/subagents`: `agents/researcher.md` (devsys `models:` family list) and `agents/reviewer.md` (devsys `models:` list and packet format; description rewritten; upstream `icon` and `modelSuggestions` removed) differ from upstream; `agents/{advisor,implementer,lens-*}.md` are new. The agent file format itself is unchanged.
 8. Thread cap (I7b.1): `orch/manager.ts` `archiveFinished` replaces the hard "Total thread limit reached" check. At `maxThreads` the oldest finished (completed/failed/stopped) thread without a retained descendant is dropped from the registry to make room; the limit is refused only when every kept thread is live, paused or a parent of one. Upstream kept finished threads forever, so long autonomous runs stalled on their own history. A dropped thread cannot be resumed with `agent_steer` (its session file stays on disk).
+9. Registry writes (OOM fix): `index.ts` `persist` signs the registry with `orch/persist-signature.ts` `registrySignature`, which leaves a starting or running thread's status line and partial output out of the change signature. Upstream wrote the whole registry (every thread, about 12 KB each) on every status change; pi never rewrites session entries, so one session grew to 2.3 GB (5,909 snapshots) and pi died loading it. Writes now happen when a thread is added or removed, starts, settles, pauses or is stopped.

package/src/subagents/index.ts

@@ -10,6 +10,7 @@ import { buildSessionContext, getAgentDir } from "@earendil-works/pi-coding-agen
 import { fuzzyFilter } from "@earendil-works/pi-tui";
 import { createInheritedToolSource } from "./orch/inherited-tools.ts";
 import { ThreadManager } from "./orch/manager.ts";
+import { registrySignature } from "./orch/persist-signature.ts";
 import { subagentPrompt } from "./orch/prompt.ts";
 import { createDriverFactory } from "./orch/runtime.ts";
 import { agentTools } from "./orch/tools.ts";
@@ -191,7 +192,7 @@ export default function piSubagent(pi: ExtensionAPI): void {
   const persist = () => {
     if (!manager) return;
     const threads = manager.saved();
-    const signature = JSON.stringify(threads);
+    const signature = registrySignature(threads);
     if (signature !== persistenceSignature) {
       pi.appendEntry(REGISTRY_ENTRY, {
         version: 1,

package/src/subagents/orch/persist-signature.ts

@@ -0,0 +1,24 @@
+import type { SavedThread } from "../types.ts";
+
+const LIVE = new Set(["starting", "running"]);
+
+/**
+ * What decides whether the registry needs writing again.
+ *
+ * pi appends every `appendEntry` to the session file and never rewrites it, and each
+ * registry entry holds every thread (about 12 KB each). A running thread changes its
+ * status line on every tool call, so signing the full snapshot wrote hundreds of
+ * kilobytes per tool call: one session reached 2.3 GB and pi ran out of memory loading
+ * it. A live thread's status and output are not needed to restore it (a reload marks it
+ * interrupted), so they stay out of the signature. Starting, settling, pausing and
+ * adding or removing a thread still write.
+ */
+export function registrySignature(threads: readonly SavedThread[]): string {
+  return JSON.stringify(
+    threads.map((thread) =>
+      LIVE.has(thread.view.state)
+        ? { ...thread, view: { ...thread.view, status: "", output: undefined } }
+        : thread,
+    ),
+  );
+}