ultimate-pi 0.23.0 → 0.25.0

package/.pi/scripts/harness-sentrux-report.mjs

@@ -31,7 +31,17 @@ function usage() {
 	process.exit(2);
 }
 
+function parseSentruxTimeoutMs() {
+	const raw = process.env.HARNESS_SENTRUX_TIMEOUT_MS;
+	if (raw?.trim()) {
+		const parsed = Number.parseInt(raw, 10);
+		if (Number.isFinite(parsed) && parsed > 0) return parsed;
+	}
+	return 300_000;
+}
+
 function runSentrux(args, projectRoot) {
+	const timeoutMs = parseSentruxTimeoutMs();
 	return new Promise((resolve, reject) => {
 		const child = spawn("sentrux", args, {
 			cwd: projectRoot,
@@ -39,6 +49,11 @@ function runSentrux(args, projectRoot) {
 		});
 		let stdout = "";
 		let stderr = "";
+		let timedOut = false;
+		const timer = setTimeout(() => {
+			timedOut = true;
+			child.kill("SIGTERM");
+		}, timeoutMs);
 		child.stdout?.on("data", (c) => {
 			stdout += c.toString();
 		});
@@ -46,6 +61,7 @@ function runSentrux(args, projectRoot) {
 			stderr += c.toString();
 		});
 		child.on("error", (err) => {
+			clearTimeout(timer);
 			if (err?.code === "ENOENT") {
 				reject(
 					Object.assign(new Error("sentrux not installed"), { code: 127 }),
@@ -55,7 +71,13 @@ function runSentrux(args, projectRoot) {
 			reject(err);
 		});
 		child.on("close", (code) => {
-			resolve({ code: code ?? 1, stdout, stderr });
+			clearTimeout(timer);
+			resolve({
+				code: timedOut ? 124 : (code ?? 1),
+				stdout,
+				stderr,
+				timedOut,
+			});
 		});
 	});
 }
@@ -104,11 +126,13 @@ function buildSignal(runId, report) {
 		run_id: runId || "unknown",
 		check_pass: check.check_pass,
 		gate_status:
-			gate.status === "degraded"
-				? "degraded"
-				: gate.status === "pass"
-					? "pass"
-					: "skipped",
+			gate.status === "timeout"
+				? "timeout"
+				: gate.status === "degraded"
+					? "degraded"
+					: gate.status === "pass"
+						? "pass"
+						: "skipped",
 		quality_signal_summary: summaryParts.join(" | ") || undefined,
 		recorded_at: report.captured_at,
 		phase: "review",
@@ -130,6 +154,7 @@ async function captureReport(projectRoot) {
 
 	const checkRun = await runSentrux(["check", projectRoot], projectRoot);
 	const gateRun = await runSentrux(["gate", projectRoot], projectRoot);
+	const timedOut = Boolean(checkRun.timedOut || gateRun.timedOut);
 
 	const checkFiltered = filterSentruxOutputLines(
 		`${checkRun.stdout}\n${checkRun.stderr}`,
@@ -160,6 +185,15 @@ async function captureReport(projectRoot) {
 
 	if (checkRun.code === 127) throw Object.assign(new Error("sentrux not installed"), { code: 127 });
 
+	if (timedOut) {
+		check.check_pass = false;
+		gate.status = "timeout";
+		gate.degraded_reasons = [
+			...(gate.degraded_reasons ?? []),
+			`sentrux CLI exceeded HARNESS_SENTRUX_TIMEOUT_MS (${parseSentruxTimeoutMs()}ms)`,
+		];
+	}
+
 	return {
 		schema_version: "1.0.0",
 		captured_at,
@@ -170,6 +204,7 @@ async function captureReport(projectRoot) {
 		check,
 		gate,
 		exit_codes: { check: checkRun.code, gate: gateRun.code },
+		timed_out: timedOut || undefined,
 	};
 }
 

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project are documented in this file.
 
 
+## [v0.25.0] — 2026-06-07
+
+### ✨ Features
+
+- Wire agent-native speed program: `parallel_probes` end-to-end, eligibility snapshot, plan FSM (`harness_plan_next_action`), synthesizer routing, auto-approve policy, per-phase spawn caps, review parallel default, 50% VCC auto-compact, ADR 0056.
+
+### 🐛 Fixes
+
+- Headless QA E2E: seed planning-context for smoke auto-approve, finalize plan on `agent_end`, write smoke ISO for `/harness-auto`, and exit via `ctx.abort()` without kill-switch false failures.
+
+## [v0.24.0] — 2026-06-06
+
+### ✨ Features
+
+- Cut harness workflow latency with phase-aware subagent timeouts, debate wall-clock caps, ccc index debounce, optional parallel review spawns, progress UI with stall detection, and PostHog phase telemetry.
+
 ## [v0.23.0] — 2026-05-28
 
 ### ✨ Features

package/README.md

@@ -77,7 +77,7 @@ If `/harness-review` returns `implementation_gap`, run:
 | `/harness-steer [--attempt N]` | Post-review repair pass for `implementation_gap`; executor reads `repair-brief.yaml`, then you re-run `/harness-review`. |
 | `/harness-abort [reason]` | Safely aborts the active run, clears plan readiness, and re-locks mutation until a fresh plan is approved. |
 
-| `/harness-clear` | Deletes only historical `.pi/harness/runs/<run_id>/` directories after mandatory confirmation; active run is preserved and non-affirmative/outage confirmation paths are no-op. |
+| `/harness-clear` | Deletes all `.pi/harness/runs/<run_id>/` directories, including the active run, after mandatory confirmation; non-affirmative/outage confirmation paths are no-op. |
 | `/harness-trace [--run <id>] [--phase plan\|execute\|evaluate\|adversary\|merge]` | Summarizes run traces and artifact handoffs for replay/forensics. |
 | `/harness-incident --trigger <reason> [--run <id>] [--severity low\|med\|high\|critical]` | Records incident, rollback, and override trail for harness failures. |
 | `/harness-sentrux-steward [--run <id>]` | Ad-hoc architectural intent review for Sentrux manifest/rule alignment. |
@@ -130,7 +130,7 @@ Subagents run isolated from the parent session. They persist canonical YAML thro
 | Need to inspect handoff | Run `/harness-trace` or inspect `.pi/harness/runs/<run_id>/`. |
 | Need to restart safely | Run `/harness-abort [reason]`, then create a fresh plan. |
 
-| Need to prune old run history safely | Run `/harness-clear`; only historical run directories are eligible and confirmation failure/cancel deletes nothing. |
+| Need to prune old run history safely | Run `/harness-clear`; all run directories, including the active run, are eligible and confirmation failure/cancel deletes nothing. |
 | Review says `implementation_gap` | Run `/harness-steer`, then `/harness-review`. |
 | Review says `plan_gap` | Revise with `/harness-plan "<updated task>"`. |
 | Sentrux missing | Install/configure Sentrux or keep it skipped; harness verification still reports the status. |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ultimate-pi",
-	"version": "0.23.0",
+	"version": "0.25.0",
 	"description": "Governed AI coding harness for pi.dev — bootstrap, plan, execute, review, and steer with deterministic policy gates",
 	"keywords": [
 		"pi-package",

package/vendor/pi-subagents/src/subagents.ts

@@ -69,10 +69,18 @@ export interface HarnessSubagentsOptions {
 	) => Promise<SpawnAuthForward | undefined>;
 	onSpawnStart?: (harnessAgentCount: number) => void;
 	onSpawnEnd?: (harnessAgentCount: number) => void;
+	/** Phase-aware default when tool params omit timeoutMs (harness bridge). */
+	resolveDefaultTimeoutMs?: (
+		params: Record<string, unknown>,
+		agents: AgentConfig[],
+		ctx: ExtensionContext,
+	) => number | undefined;
 	onCompleted?: (details: {
 		agents: string[];
 		mode: string;
 		durationMs: number;
+		timedOut?: boolean;
+		stop_reason?: "timeout" | "complete" | "aborted";
 	}) => void;
 	truncateDetails?: boolean;
 }
@@ -1387,7 +1395,13 @@ export function createSubagentsExtension(
 			const agentScope: AgentScope = params.agentScope ?? defaultScope;
 			const discovery = discoverAgents(ctx.cwd, agentScope, packageRoot);
 			const agents = discovery.agents;
-			const defaultTimeoutMs = params.timeoutMs ?? ENV_TIMEOUT_MS;
+			const resolvedDefault = options.resolveDefaultTimeoutMs?.(
+				params as Record<string, unknown>,
+				agents,
+				ctx,
+			);
+			const defaultTimeoutMs =
+				params.timeoutMs ?? resolvedDefault ?? ENV_TIMEOUT_MS;
 			const effectiveConfirmProjectAgents =
 				params.confirmProjectAgents ?? defaultConfirm;
 			const harnessAgents = collectHarnessAgents(params);
@@ -1430,6 +1444,7 @@ export function createSubagentsExtension(
 			}
 
 			options.onSpawnStart?.(harnessAgents.length);
+			let spawnTimedOut = false;
 			try {
 				const mode = modeInfo(params);
 				if (mode.modeCount !== 1 || (params.aggregator && !mode.hasTasks)) {
@@ -1475,15 +1490,25 @@ export function createSubagentsExtension(
 					};
 				}
 
-				if (mode.hasChain) return executeChainMode(execCtx);
-				if (mode.hasTasks) return executeParallelMode(execCtx);
-				if (mode.hasSingle) return executeSingleMode(execCtx);
-
-				const available = agents.map((a) => `${a.name} (${a.source})`).join(", ") || "none";
-				return {
-					content: [{ type: "text" as const, text: `Invalid parameters. Available agents: ${available}` }],
-					details: makeDetails("single")([]),
-				};
+				let toolResult: Awaited<
+					ReturnType<typeof executeSingleMode>
+				>;
+				if (mode.hasChain) toolResult = await executeChainMode(execCtx);
+				else if (mode.hasTasks) toolResult = await executeParallelMode(execCtx);
+				else if (mode.hasSingle) toolResult = await executeSingleMode(execCtx);
+				else {
+					const available = agents.map((a) => `${a.name} (${a.source})`).join(", ") || "none";
+					return {
+						content: [{ type: "text" as const, text: `Invalid parameters. Available agents: ${available}` }],
+						details: makeDetails("single")([]),
+					};
+				}
+				const allResults = [
+					...(toolResult.details?.results ?? []),
+					...(toolResult.details?.aggregator ? [toolResult.details.aggregator] : []),
+				];
+				spawnTimedOut = allResults.some((r) => r.timedOut === true);
+				return toolResult;
 			} finally {
 				options.onSpawnEnd?.(harnessAgents.length);
 				const mode = params.chain?.length
@@ -1495,6 +1520,12 @@ export function createSubagentsExtension(
 					agents: harnessAgents,
 					mode,
 					durationMs: Date.now() - startedAt,
+					timedOut: spawnTimedOut,
+					stop_reason: spawnTimedOut
+						? "timeout"
+						: signal?.aborted
+							? "aborted"
+							: "complete",
 				});
 			}
 		},