@jwilger/pi-development-system 0.40.0 → 0.41.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jwilger/pi-development-system",
-  "version": "0.40.0",
+  "version": "0.41.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

@@ -40,3 +40,4 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 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).

package/src/subagents/orch/manager.ts

@@ -257,8 +257,7 @@ export class ThreadManager {
         : level > maxLevels
     )
       throw new Error("Agent depth limit reached");
-    if (this.records.size >= (this.options.maxThreads ?? DEFAULT_MANAGER_SETTINGS.maxThreads))
-      throw new Error("Total thread limit reached");
+    this.archiveFinished(this.options.maxThreads ?? DEFAULT_MANAGER_SETTINGS.maxThreads);
     this.assertCapacity();
     const type = structuredClone(this.options.getType(args.type));
     if (overrides !== undefined) type.spawnOverrides = { ...overrides };
@@ -761,6 +760,24 @@ export class ThreadManager {
       }
     }
   }
+  /**
+   * devsys: a finished thread must never block new work, or long autonomous runs stall
+   * on their own history. Make room for one more thread by dropping the oldest finished
+   * thread that has no retained descendant; live and paused threads are never dropped.
+   * Throws only when every retained thread is still live, paused or a parent of one.
+   */
+  private archiveFinished(limit: number): void {
+    while (this.records.size >= limit) {
+      const paths = [...this.records.keys()];
+      const victim = paths.find((path) => {
+        const state = this.records.get(path)?.view.state;
+        const finished = state === "completed" || state === "failed" || state === "stopped";
+        return finished && !paths.some((other) => isDescendant(other, path));
+      });
+      if (victim === undefined) throw new Error("Total thread limit reached");
+      this.records.delete(victim);
+    }
+  }
   private assertCapacity(): void {
     if (
       [...this.records.values()].filter((record) => active(record.view)).length >=

package/src/subagents/ui/settings-ui.ts

@@ -34,7 +34,7 @@ const FIELDS = [
   {
     id: "maxThreads",
     label: "Retained threads",
-    help: "How many agent sessions can be kept for follow-up work, including completed and paused agents.\nAt the limit, new agents cannot start.\nPositive safe integer.",
+    help: "How many agent sessions can be kept for follow-up work, including completed and paused agents.\nAt the limit the oldest finished agent is dropped to make room; new agents are refused only when every kept agent is still active, paused or has a kept child.\nPositive safe integer.",
   },
 ] as const;