@leing2021/super-pi 0.22.0 → 0.22.1

package/extensions/subagent/throttle.ts

@@ -0,0 +1,77 @@
+/**
+ * Throttle utility for subagent event streams.
+ * Prevents render storms by coalescing high-frequency onUpdate calls.
+ */
+
+/**
+ * Resolve the throttle interval based on parallel task count.
+ * Returns 0 for single task (no throttling needed).
+ */
+export function resolveThrottleInterval(taskCount: number): number {
+	if (taskCount <= 1) return 0;
+	if (taskCount <= 4) return 200;
+	if (taskCount <= 8) return 500;
+	return 1000;
+}
+
+/**
+ * Create a throttled version of a function.
+ *
+ * - First call executes immediately.
+ * - Subsequent calls within `intervalMs` are coalesced; only the latest args are kept.
+ * - After `intervalMs`, if there was a pending call, it fires with the latest args.
+ * - `flush()` immediately executes any pending call.
+ * - `dispose()` cancels the timer and prevents future trailing calls.
+ */
+export function createThrottle<T extends (...args: any[]) => void>(
+	fn: T,
+	intervalMs: number,
+): T & { flush(): void; dispose(): void } {
+	let pendingArgs: any[] | null = null;
+	let timer: ReturnType<typeof setTimeout> | null = null;
+
+	function execute(args: any[]) {
+		pendingArgs = null;
+		timer = null;
+		fn(...args);
+	}
+
+	const throttled = function (this: unknown, ...args: any[]) {
+		if (timer === null) {
+			// First call — execute immediately
+			execute(args);
+			timer = setTimeout(() => {
+				if (pendingArgs !== null) {
+					execute(pendingArgs);
+				} else {
+					timer = null;
+				}
+			}, intervalMs);
+			if (timer && typeof timer === "object" && "unref" in timer) {
+				(timer as ReturnType<typeof setTimeout> & { unref(): void }).unref();
+			}
+		} else {
+			// Within interval — save latest args
+			pendingArgs = args;
+		}
+	} as T & { flush(): void; dispose(): void };
+
+	throttled.flush = () => {
+		if (pendingArgs !== null) {
+			if (timer !== null) {
+				clearTimeout(timer);
+			}
+			execute(pendingArgs);
+		}
+	};
+
+	throttled.dispose = () => {
+		if (timer !== null) {
+			clearTimeout(timer);
+			timer = null;
+		}
+		pendingArgs = null;
+	};
+
+	return throttled;
+}

package/extensions/subagent/top-level-async.ts

@@ -1,5 +1,6 @@
-// Based on pi-subagents by Nico Bailon (https://github.com/nicobailon/pi-subagents)
-// MIT License
+// SPDX-FileCopyrightText: 2025 Nico Bailon
+// SPDX-License-Identifier: MIT
+// Source: https://github.com/nicobailon/pi-subagents
 export interface AsyncOverrideParams {
 	async?: boolean;
 	clarify?: boolean;

package/extensions/subagent/types.ts

@@ -1,5 +1,6 @@
-// Based on pi-subagents by Nico Bailon (https://github.com/nicobailon/pi-subagents)
-// MIT License
+// SPDX-FileCopyrightText: 2025 Nico Bailon
+// SPDX-License-Identifier: MIT
+// Source: https://github.com/nicobailon/pi-subagents
 /**
  * Type definitions for the subagent extension
  */

package/extensions/subagent/utils.ts

@@ -1,5 +1,6 @@
-// Based on pi-subagents by Nico Bailon (https://github.com/nicobailon/pi-subagents)
-// MIT License
+// SPDX-FileCopyrightText: 2025 Nico Bailon
+// SPDX-License-Identifier: MIT
+// Source: https://github.com/nicobailon/pi-subagents
 /**
  * General utility functions for the subagent extension
  */

package/extensions/subagent/worktree.ts

@@ -1,5 +1,6 @@
-// Based on pi-subagents by Nico Bailon (https://github.com/nicobailon/pi-subagents)
-// MIT License
+// SPDX-FileCopyrightText: 2025 Nico Bailon
+// SPDX-License-Identifier: MIT
+// Source: https://github.com/nicobailon/pi-subagents
 import { spawnSync } from "node:child_process";
 import * as fs from "node:fs";
 import * as os from "node:os";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leing2021/super-pi",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "private": false,
   "type": "module",
   "description": "Pi-native Compound Engineering package for iterative development workflows",
@@ -25,6 +25,8 @@
     "skills",
     "extensions",
     "rules",
+    "THIRD-PARTY-NOTICES.md",
+    "LICENSE",
     "README.md",
     "package.json"
   ],