ultimate-pi 0.18.0 → 0.19.0

package/.pi/extensions/harness-debate-tools.ts

@@ -5,67 +5,51 @@
 import { mkdir, readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { Type } from "@sinclair/typebox";
-import { parse as parseYaml } from "yaml";
-import type { DebateParticipant } from "../lib/debate-orchestrator-types.js";
+import { claimHarnessGovernanceLoad } from "../lib/extension-load-guard.js";
 import {
+	captureHarnessEvent,
+	DEBATE_AGENT_SUBMIT_TOOL,
+	type DebateParticipant,
 	extractLastSubmitCall,
-	type MessageLike,
-} from "../lib/harness-agent-output.js";
-import {
 	getLatestRunContext,
 	getRunIdFromSession,
-} from "../lib/harness-run-context.js";
-import { writeYamlFile } from "../lib/harness-yaml.js";
+	type MessageLike,
+	parseYaml,
+	Type,
+	writeYamlFile,
+} from "../lib/harness-debate-core-deps.js";
 import {
 	acceptDebateRound,
-	capsForDebate,
-	finalizeDebateConsensus,
-	openDebateBus,
-} from "./lib/debate-bus-core.js";
-import { getDebateState } from "./lib/debate-bus-state.js";
-import { claimExtensionLoad } from "./lib/extension-load-guard.js";
-import { captureHarnessEvent } from "./lib/harness-posthog.js";
-import { DEBATE_AGENT_SUBMIT_TOOL } from "./lib/harness-subagent-submit-registry.js";
-import {
-	type DebateEligibilityInput,
-	harnessPlanDebateEligibility,
-} from "./lib/plan-debate-eligibility.js";
-import {
-	buildPlanReviewRoundEnvelope,
-	type PlanReviewRoundDraft,
-} from "./lib/plan-debate-envelope.js";
-import {
-	getPlanFocusCoverage,
-	planDebateOutcomeComplete,
-} from "./lib/plan-debate-focus.js";
-import {
-	normalizePlanDebateId,
-	planDebateIdForRun,
-} from "./lib/plan-debate-id.js";
-import {
 	applyDebateLane,
 	applyDebateLaneFromDoc,
+	assessPlanScopeDrift,
+	buildPlanReviewRoundEnvelope,
+	capsForDebate,
+	type DebateEligibilityInput,
 	type DebateLaneKind,
 	debateLaneForAgent,
+	finalizeDebateConsensus,
 	formatApplyLaneMessage,
-} from "./lib/plan-debate-lane.js";
-import { getPlanDebateRoundStatus } from "./lib/plan-debate-round-status.js";
-import { withReviewRoundYamlWrite } from "./lib/plan-debate-write-guard.js";
-import {
 	formatTranscriptForSpawn,
+	getDebateState,
 	getMessengerRoundState,
+	getPlanDebateRoundStatus,
+	getPlanFocusCoverage,
+	harnessPlanDebateEligibility,
 	initPlanMessenger,
 	loadMessengerState,
+	loadValidationTurnYaml,
 	messengerRoundDebateReady,
+	normalizePlanDebateId,
+	openDebateBus,
+	type PlanReviewRoundDraft,
+	planDebateIdForRun,
+	planDebateOutcomeComplete,
 	postMessengerMessage,
 	readRoundTranscript,
-} from "./lib/plan-messenger.js";
-import {
-	loadValidationTurnYaml,
 	validateIntegratorDraft,
-} from "./lib/plan-review-integrator-rules.js";
-import { assessPlanScopeDrift } from "./lib/plan-scope-guard.js";
+	withReviewRoundYamlWrite,
+} from "../lib/harness-debate-workflow-deps.js";
 
 // @ts-expect-error pi extensions run as ESM
 const MODULE_URL = import.meta.url;
@@ -115,7 +99,7 @@ function subagentResults(
 const USE_SUBMIT_TOOLS = process.env.HARNESS_SUBMIT_TOOLS !== "0";
 
 export default function harnessDebateTools(pi: ExtensionAPI) {
-	if (!claimExtensionLoad("harness-debate-tools", MODULE_URL)) return;
+	if (!claimHarnessGovernanceLoad("harness-debate-tools", MODULE_URL)) return;
 
 	pi.on("tool_result", async (event, ctx) => {
 		if (event.isError || event.toolName !== "subagent") return;

package/.pi/extensions/harness-lens.ts

@@ -0,0 +1,94 @@
+import * as path from "node:path";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import {
+	captureHarnessEvent,
+	type HarnessPostHogEventName,
+} from "../lib/harness-posthog.js";
+
+const LENS_EVENT_TO_POSTHOG: Record<string, HarnessPostHogEventName> = {
+	"pi-lens/analysis-complete": "harness_lens_analysis_complete",
+	"pi-lens/findings": "harness_lens_findings",
+	"pi-lens/turn-findings": "harness_lens_turn_findings",
+};
+
+type EventBusLike = {
+	on?: (event: string, handler: (payload: unknown) => void) => void;
+};
+
+function lensConfigRoot(cwd = process.cwd()): string {
+	return path.join(cwd, ".pi", "harness", ".lens");
+}
+
+function configureHarnessLensPaths(): void {
+	const root = lensConfigRoot();
+	process.env.PI_LENS_CONFIG_PATH ??= path.join(root, "config.json");
+	process.env.PILENS_DATA_DIR ??= path.join(root, "projects");
+	process.env.PI_LENS_DASHBOARD = "0";
+}
+
+function toCount(value: unknown): number {
+	return Array.isArray(value) ? value.length : 0;
+}
+
+function firstString(...values: unknown[]): string | undefined {
+	for (const value of values) {
+		if (typeof value === "string" && value.trim()) return value;
+	}
+	return undefined;
+}
+
+function lensPostHogProperties(
+	eventName: string,
+	payload: Record<string, unknown>,
+): Record<string, unknown> {
+	return {
+		lens_event: eventName,
+		lens_source: "harness-lens",
+		tool_name: firstString(payload.toolName, payload.tool_name) ?? "",
+		model: firstString(payload.model) ?? "unknown",
+		file_path: firstString(payload.filePath, payload.file_path) ?? "",
+		file_count: toCount(payload.filePaths),
+		diagnostic_count: toCount(payload.diagnostics),
+		blocker_count: toCount(payload.blockers),
+		warning_count: toCount(payload.warnings),
+		fixed_count: toCount(payload.fixed),
+		resolved_count: Number(payload.resolvedCount ?? 0),
+		duration_ms: Number(payload.durationMs ?? 0),
+		has_blockers: Boolean(payload.hasBlockers),
+		file_modified: Boolean(payload.fileModified),
+		changed_file_count: toCount(payload.changedFiles),
+		blocker_sections: Number(payload.blockerSections ?? 0),
+		advisory_sections: Number(payload.advisorySections ?? 0),
+	};
+}
+
+function installLensPostHogBridge(pi: ExtensionAPI): void {
+	const bus = (pi as { events?: EventBusLike }).events;
+	if (typeof bus?.on !== "function") return;
+
+	for (const [eventName, posthogEvent] of Object.entries(
+		LENS_EVENT_TO_POSTHOG,
+	)) {
+		bus.on(eventName, (payload: unknown) => {
+			if (!payload || typeof payload !== "object") return;
+			const data = payload as Record<string, unknown>;
+			const distinctId =
+				firstString(data.sessionId, data.pi_session_id) ?? "harness-lens";
+			captureHarnessEvent(
+				distinctId,
+				posthogEvent,
+				lensPostHogProperties(eventName, data),
+			);
+		});
+	}
+}
+
+export default async function harnessLens(pi: ExtensionAPI) {
+	configureHarnessLensPaths();
+	installLensPostHogBridge(pi);
+
+	const lens = (await import("../lib/harness-lens/index.js")) as unknown as {
+		default: (pi: ExtensionAPI) => unknown;
+	};
+	return lens.default(pi);
+}

package/.pi/extensions/harness-live-widget.ts

@@ -2,6 +2,7 @@ import type {
 	ExtensionAPI,
 	ExtensionContext,
 } from "@earendil-works/pi-coding-agent";
+import { isHarnessProjectEnabled } from "../lib/harness-project-config.js";
 import { evaluateCrossSessionResume } from "../lib/harness-run-context.js";
 import {
 	deriveHarnessStatusHint,
@@ -245,7 +246,7 @@ export default function harnessLiveWidget(pi: ExtensionAPI) {
 	let mountCtx: ExtensionContext | null = null;
 
 	function mountHarnessWidget(ctx: ExtensionContext): void {
-		if (!ctx.hasUI) return;
+		if (!ctx.hasUI || !isHarnessProjectEnabled()) return;
 		const state = stateStore.refresh(ctx);
 		lastRenderHash = computeRenderHash(state);
 
@@ -270,9 +271,21 @@ export default function harnessLiveWidget(pi: ExtensionAPI) {
 		updateStatusFallback(ctx, state);
 	}
 
+	function clearHarnessWidget(ctx: ExtensionContext): void {
+		if (!ctx.hasUI) return;
+		const tui = tuiHandle;
+		ctx.ui.setWidget("harness-live", undefined);
+		ctx.ui.setStatus("harness-mode", undefined);
+		widgetMounted = false;
+		tuiHandle = null;
+		component = null;
+		lastRenderHash = "";
+		tui?.requestRender();
+	}
+
 	function remountHarnessLiveWidget(ctx: ExtensionContext): void {
 		if (!ctx.hasUI || !widgetMounted) return;
-		ctx.ui.setWidget("harness-live", undefined);
+		clearHarnessWidget(ctx);
 		mountHarnessWidget(ctx);
 	}
 
@@ -300,6 +313,20 @@ export default function harnessLiveWidget(pi: ExtensionAPI) {
 		if (mountCtx) scheduleRefresh(mountCtx);
 	});
 
+	pi.events.on("harness-project-enabled:changed", (payload: unknown) => {
+		const data =
+			payload && typeof payload === "object"
+				? (payload as { enabled?: boolean })
+				: null;
+		if (!mountCtx || typeof data?.enabled !== "boolean") return;
+		if (data.enabled) {
+			mountHarnessWidget(mountCtx);
+			tuiHandle?.requestRender();
+			return;
+		}
+		clearHarnessWidget(mountCtx);
+	});
+
 	function updateStatusFallback(
 		ctx: ExtensionContext,
 		state: HarnessUiState,
@@ -330,6 +357,10 @@ export default function harnessLiveWidget(pi: ExtensionAPI) {
 		refreshQueued = true;
 		queueMicrotask(() => {
 			refreshQueued = false;
+			if (!isHarnessProjectEnabled()) {
+				clearHarnessWidget(ctx);
+				return;
+			}
 			const state = stateStore.refresh(ctx);
 			const hash = computeRenderHash(state);
 			updateStatusFallback(ctx, state);

package/.pi/extensions/harness-plan-approval.ts

@@ -4,6 +4,7 @@
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
+import { claimHarnessGovernanceLoad } from "../lib/extension-load-guard.js";
 import type { PlanPacketLike } from "../lib/harness-run-context.js";
 import {
 	appendPlanApprovalIfNew,
@@ -12,47 +13,46 @@ import {
 	parsePlanApprovalFromMessage,
 	planPacketSummary,
 } from "../lib/harness-run-context.js";
-import { claimExtensionLoad } from "./lib/extension-load-guard.js";
 import {
 	CREATE_PLAN_GUIDELINES,
 	CREATE_PLAN_SNIPPET,
 	executeCreatePlan,
 	formatCreatePlanResultText,
-} from "./lib/plan-approval/create-plan.js";
+} from "../lib/plan-approval/create-plan.js";
 import {
 	buildPlanApprovalMarkdown,
 	runPlanApprovalDialog,
-} from "./lib/plan-approval/dialog.js";
-import { writePlanReviewMarkdown } from "./lib/plan-approval/plan-review.js";
+} from "../lib/plan-approval/dialog.js";
+import { writePlanReviewMarkdown } from "../lib/plan-approval/plan-review.js";
 import {
 	renderApprovePlanCall,
 	renderApprovePlanResult,
 	renderHarnessPlanDraft,
-} from "./lib/plan-approval/render.js";
-import { resolveApprovePlanParamsFromDisk } from "./lib/plan-approval/resolve-disk.js";
+} from "../lib/plan-approval/render.js";
+import { resolveApprovePlanParamsFromDisk } from "../lib/plan-approval/resolve-disk.js";
 import {
 	ApprovePlanParamsSchema,
 	CreatePlanParamsSchema,
 	PROMPT_GUIDELINES,
 	PROMPT_SNIPPET,
-} from "./lib/plan-approval/schema.js";
+} from "../lib/plan-approval/schema.js";
 import type {
 	ApprovePlanParams,
 	PlanApprovalDialogResult,
-} from "./lib/plan-approval/types.js";
+} from "../lib/plan-approval/types.js";
 import {
 	formatApprovePlanResultText,
 	toApprovePlanToolDetails,
 	validateApprovePlanParams,
-} from "./lib/plan-approval/validate.js";
-import { validatePlanApprovalReadiness } from "./lib/plan-approval-readiness.js";
-import { validatePlanDebateGate } from "./lib/plan-debate-gate.js";
+} from "../lib/plan-approval/validate.js";
+import { validatePlanApprovalReadiness } from "../lib/plan-approval-readiness.js";
+import { validatePlanDebateGate } from "../lib/plan-debate-gate.js";
 
 // @ts-expect-error pi extensions run as ESM
 const MODULE_URL = import.meta.url;
 
 export default function harnessPlanApproval(pi: ExtensionAPI) {
-	if (!claimExtensionLoad("harness-plan-approval", MODULE_URL)) return;
+	if (!claimHarnessGovernanceLoad("harness-plan-approval", MODULE_URL)) return;
 	pi.registerMessageRenderer(
 		"harness-plan-draft",
 		(message, _options, theme) => {