pi-harness-runtime 1.1.404 → 1.1.405

package/index.ts

@@ -296,6 +296,240 @@ function waitBelongsToRequest(requestId: string | undefined): boolean {
 	return active === requestId;
 }
 
+// --- tooling-preference: the Biome proposal ---------------------------------
+//
+// The proposal ("use Biome.js instead of ESLint and Prettier") is a decision
+// of its own. It never travels through the task-approval path: a "No" here
+// must not pause the work and a "Yes" must not resume a pending question.
+
+/** The proposals of this session - the first answer wins. */
+interface ToolingProposalRequest {
+	requestId: string;
+	workspaceRoot: string;
+	userKey: string;
+}
+
+interface ToolingProposalRegistry {
+	register(request: ToolingProposalRequest): boolean;
+	claim(
+		requestId: string,
+		choice: "yes" | "no",
+		channel?: string,
+	): {
+		request: ToolingProposalRequest;
+		resolution: {
+			choice: "yes" | "no";
+			preference: "prefer_biome" | "use_project_tools";
+			channel?: string;
+		};
+	} | null;
+}
+
+interface ToolingProposalStore {
+	read(
+		userKey: string,
+		workspaceRoot: string,
+	): { decision?: "prefer_biome" | "use_project_tools"; askedAt?: string } | undefined;
+	markAsked(userKey: string, workspaceRoot: string, requestId: string): void;
+	recordDecision(
+		userKey: string,
+		workspaceRoot: string,
+		decision: "prefer_biome" | "use_project_tools",
+		requestId: string,
+		channel?: string,
+	): void;
+}
+
+let _toolingRegistry: ToolingProposalRegistry | null = null;
+let _toolingStore: ToolingProposalStore | null = null;
+/** The identity of the person the notifications reach (never logged). */
+let _toolingIdentity = "";
+/**
+ * The identity of the person the notifications reach.
+ *
+ * It is read from the channel key files, so a LINE-only setup is recognized
+ * too. The value is hashed before it is stored and never reaches a log.
+ */
+function readToolingIdentity(): string {
+	if (_toolingIdentity) return _toolingIdentity;
+	const home = process.env.HOME || process.env.USERPROFILE || "";
+	if (!home) return "";
+	const keysDir = `${home}/.pi-harness-runtime/keys`;
+	for (const name of ["telegram-chat-id.txt", "line-user-id.txt"]) {
+		try {
+			const value = readFileSync(`${keysDir}/${name}`, "utf8").trim();
+			if (value) {
+				_toolingIdentity = value;
+				return value;
+			}
+		} catch {
+			// The key file is optional - the channel may not be configured.
+		}
+	}
+	return "";
+}
+/** The running extension API - the relay path has no `pi` of its own. */
+let _extensionApi: ExtensionAPI | null = null;
+/** How long an unanswered proposal stays quiet before it is offered again. */
+const TOOLING_PROPOSAL_COOLDOWN_MS = 30 * 24 * 60 * 60 * 1000;
+
+/**
+ * Load the tooling preference package and watch for the session start.
+ *
+ * The proposal is offered once per workspace: the answer is stored, and a
+ * workspace that already uses Biome is never asked at all.
+ */
+async function initToolingPreference(pi: ExtensionAPI): Promise<void> {
+	try {
+		const mod = await import("./packages/tooling-preference/dist/index.js");
+		_toolingRegistry = new mod.ToolingRequestRegistry();
+		_toolingStore = new mod.ToolingPreferenceStore(
+			mod.ToolingPreferenceStore.defaultFilePath(),
+		);
+	} catch (error) {
+		logToFile("[ToolingPreference]", `package unavailable: ${oneLineError(error)}`);
+		return;
+	}
+
+	pi.on("session_start", () => {
+		void offerToolingPreference();
+	});
+}
+
+/**
+ * Offer the tooling proposal for the workspace of this session.
+ *
+ * The proposal never blocks: it is a message with two buttons, and the work
+ * continues while the user decides.
+ */
+async function offerToolingPreference(): Promise<void> {
+	const registry = _toolingRegistry;
+	const store = _toolingStore;
+	const center = _nc?.center as NcCenter | undefined;
+	if (!registry || !store || !center?.notifyWithButtons) return;
+
+	let workspaceRoot: string;
+	try {
+		workspaceRoot = realpathSync(process.cwd());
+	} catch {
+		return;
+	}
+
+	try {
+		const mod = await import("./packages/tooling-preference/dist/index.js");
+		const userKey = mod.buildToolingUserKey(readToolingIdentity());
+		const record = store.read(userKey, workspaceRoot);
+		if (!mod.shouldAskAgain(record, TOOLING_PROPOSAL_COOLDOWN_MS)) return;
+
+		const context = mod.detectToolingContext(workspaceRoot);
+		const eligibility = mod.evaluateBiomeProposalEligibility(context);
+		if (!eligibility.eligible) {
+			logToFile("[ToolingPreference]", `no proposal: ${eligibility.reason}`);
+			return;
+		}
+
+		const requestId = mod.buildToolingRequestId(userKey, workspaceRoot);
+		if (!registry.register({ requestId, workspaceRoot, userKey })) return;
+
+		await center.notifyWithButtons(
+			"ToolingPreferenceProposal",
+			{
+				jobId: requestId,
+				questionId: requestId,
+				requirement: mod.buildToolingProposalMessage(context),
+				taskTitle: "Biome.js proposal",
+			},
+			mod.buildToolingButtons(requestId),
+			{ additionalDetails: { _actionPrompt: "Use Biome.js in this workspace?" } },
+		);
+		store.markAsked(userKey, workspaceRoot, requestId);
+		logToFile("[ToolingPreference]", `proposal sent (${requestId})`);
+	} catch (error) {
+		logToFile("[ToolingPreference]", `proposal failed: ${oneLineError(error)}`);
+	}
+}
+
+/**
+ * Apply the answer of the user to the tooling proposal.
+ *
+ * The first answer wins: a second click finds nothing and changes nothing.
+ */
+async function resolveToolingPreference(
+	targetId: string,
+	channel: "telegram" | "line",
+	pi: ExtensionAPI | null,
+): Promise<{ applied: boolean; reason: string }> {
+	const registry = _toolingRegistry;
+	const store = _toolingStore;
+	if (!registry || !store) {
+		return { applied: false, reason: "no proposal is open" };
+	}
+
+	let target: { choice: "yes" | "no"; requestId: string } | null = null;
+	try {
+		const mod = await import("./packages/tooling-preference/dist/index.js");
+		target = mod.parseToolingTarget(targetId);
+	} catch (error) {
+		logToFile("[ToolingPreference]", `package unavailable: ${oneLineError(error)}`);
+		return { applied: false, reason: "the proposal cannot be read" };
+	}
+	if (!target) {
+		return { applied: false, reason: "the button does not belong to a proposal" };
+	}
+
+	const claimed = registry.claim(target.requestId, target.choice, channel);
+	if (!claimed) {
+		return { applied: false, reason: "the proposal was already answered" };
+	}
+
+	store.recordDecision(
+		claimed.request.userKey,
+		claimed.request.workspaceRoot,
+		claimed.resolution.preference,
+		target.requestId,
+		channel,
+	);
+	logToFile(
+		"[ToolingPreference]",
+		`${channel} answered the proposal: ${claimed.resolution.preference}`,
+	);
+
+	if (claimed.resolution.choice === "yes" && pi) {
+		await startBiomeImplementation(claimed.request.workspaceRoot, channel, pi);
+	}
+	return {
+		applied: true,
+		reason:
+			claimed.resolution.choice === "yes"
+				? "Biome.js will be implemented"
+				: "the current tools stay",
+	};
+}
+
+/**
+ * Start the Biome implementation after a "Yes".
+ *
+ * The harness does not change the repository itself: the agent does the
+ * work, so the change stays reviewable in the session.
+ */
+async function startBiomeImplementation(
+	workspaceRoot: string,
+	channel: string,
+	pi: ExtensionAPI,
+): Promise<void> {
+	try {
+		const mod = await import("./packages/tooling-preference/dist/index.js");
+		const context = mod.detectToolingContext(workspaceRoot);
+		await pi.sendUserMessage(
+			mod.buildToolingImplementationPrompt(context, workspaceRoot),
+			{ deliverAs: "steer" },
+		);
+		logToFile("[ToolingPreference]", `agent asked to implement Biome (${channel})`);
+	} catch (error) {
+		logToFile("[ToolingPreference]", `steer failed: ${oneLineError(error)}`);
+	}
+}
+
 async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 	addHarnessMessage("Jev", "initializing", "wait");
 	try {
@@ -1656,6 +1890,10 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 		const lineAccessToken = hasLineCredentials ? readFileSync(lineTokenPath, "utf8").trim() : null;
 		const lineUserId = hasLineCredentials ? readFileSync(lineUserIdPath, "utf8").trim() : null;
 
+		// The identity of the person the notifications reach. It is hashed
+		// before it is stored and never reaches a log file.
+		_toolingIdentity = chatId || lineUserId || "";
+
 		if (!botToken || !chatId) {
 			logStartup("[pi-harness] Telegram: bot token or chat ID is empty — skipping");
 			const emptyFixes = keyFileFixesOrFallback("Telegram", ["bot token", "chat id"]);
@@ -1782,6 +2020,21 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 			}
 
 			switch (parsed.action) {
+				case CallbackActions.TOOLING_PREFERENCE: {
+					// The proposal is a decision of its own: it never resolves a
+					// pending question and it never pauses the work.
+					const result = await resolveToolingPreference(
+						parsed.targetId,
+						"telegram",
+						pi,
+					);
+					await acknowledge(
+						result.applied
+							? `Saved - ${result.reason}`
+							: `Stale button - ${result.reason}`,
+					);
+					break;
+				}
 				case CallbackActions.APPROVE: {
 					// The user clicked Continue. The request ID in the
 					// callback data is the canonical one, so the click
@@ -2268,7 +2521,21 @@ async function initRelayStream(): Promise<void> {
 				// A LINE postback is the same decision as a Telegram button
 				// click: one resolver, the same canonical request ID.
 				if (callback.type === "line_callback") {
-					applyChannelApproval(callback.action, callback.targetId, "line");
+					if (
+						callback.action === "biome" ||
+						callback.action.startsWith("biome_")
+					) {
+						// The tooling proposal is a decision of its own: it never
+						// resolves a pending question and it never pauses the
+						// work. The postback data may arrive split or as one
+						// string - both carry the choice and the request ID.
+						const raw = callback.action.startsWith("biome_")
+							? callback.action.slice("biome_".length)
+							: callback.targetId;
+						await resolveToolingPreference(raw, "line", _extensionApi);
+					} else {
+						applyChannelApproval(callback.action, callback.targetId, "line");
+					}
 				}
 
 				// Forward Telegram callbacks to the adapter
@@ -3621,6 +3888,9 @@ export default async function (pi: ExtensionAPI) {
 	const tracker = new UsageTracker();
 	const mirrorStore = new MirrorStore();
 	ensureHarnessDir();
+	// The relay path has no `pi` of its own - the extension API is kept
+	// here so every path can reach the agent.
+	_extensionApi = pi;
 
 	// --- central-logging: ship structured logs to R2 / the webhook server ---
 	// The pipeline is opt-in by configuration, never by code: without R2
@@ -3675,6 +3945,10 @@ export default async function (pi: ExtensionAPI) {
 	// Collect promise so we can wait for initialization before showing startup notification
 	asyncInitPromises.push(initQdrant());
 
+	// --- tooling-preference: offer Biome.js instead of ESLint/Prettier ------
+	// The proposal is a decision of its own: it never pauses the work.
+	void initToolingPreference(pi);
+
 	// --- telegram-notifications: Telegram bot for harness event notifications ----
 	// Collect promise so we can wait for initialization before showing startup notification
 	asyncInitPromises.push(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "[BETA] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes.",
   "type": "module",
   "scripts": {

package/packages/a2a-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/a2a-adapter",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "Google Agent-to-Agent (A2A) protocol adapter for pi-harness",
   "main": "dist/index.js",

package/packages/agent-policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/agent-policy",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Agent policy runtime for pi-harness - enforces mandatory rule delivery and mutation gating",
   "type": "module",
   "main": "./dist/index.js",

package/packages/architecture-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/architecture-generator",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Generate ADR and Mermaid diagrams from project analysis",
   "type": "module",
   "main": "./dist/index.js",

package/packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/auth",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "pi-harness-runtime — auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/autonomous-refactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-refactor",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "Autonomous refactoring engine",
   "main": "dist/index.js",

package/packages/autonomous-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-runtime",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Autonomous Operations Runtime — task inbox, lease management, and worker lifecycle (RFC-0101)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cache-strategy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cache-strategy",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "Smart caching with TTL and invalidation strategies (RFC-0022)",
   "main": "dist/index.js",

package/packages/capability-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/capability-registry",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Capability Registry for pi-harness-runtime — tracks model capabilities and enables capability-based routing",
   "type": "module",
   "main": "./dist/index.js",

package/packages/checkpoint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/checkpoint",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Enhanced checkpoint system with incremental snapshots, diff-based storage, and recovery strategies",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cli-plugin-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cli-plugin-sdk",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "CLI Plugin SDK for pi-harness — install, list, remove, update, invoke plugins",
   "main": "dist/index.js",

package/packages/clipboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/clipboard-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard-plugin",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Code generation pipeline for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/code-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-review",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Automated code review engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/codex-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/codex-adapter",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "OpenAI Codex provider adapter for pi-harness",
   "main": "dist/index.js",

package/packages/codex-watcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/codex-watcher",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Watches Codex CLI sessions and emits visible messages for PING-PONG monitoring",
   "type": "module",
   "main": "./dist/src/index.js",

package/packages/config-capture/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/config-capture",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Auto-capture API-fetched configuration values to AGENTS.md",
   "type": "module",
   "main": "src/index.ts",

package/packages/connection-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/connection-runtime",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "Connection management with jittered exponential backoff for pi-harness",
   "main": "./dist/index.js",

package/packages/context-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-compiler",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Bounded context selection engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/context-discovery/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-discovery",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/context-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/context-manager",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Context Window Manager — prevents model context overflow via compaction and resume prompts (RFC-0010)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/contracts",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "RPC schema definitions for pi-harness runtime",
   "main": "./dist/index.js",

package/packages/cookie-sanitizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cookie-sanitizer",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "pi-harness-runtime — cookie sanitizer (provider-quota cookie file normaliser)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cost-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cost-optimizer",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Cost Optimizer for pi-harness-runtime — budget tracking, forecasting, and model selection optimization",
   "type": "module",
   "main": "./dist/index.js",

package/packages/dependency-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/dependency-analyzer",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Django framework analysis — models, management commands, settings",
   "type": "module",
   "main": "./dist/index.js",

package/packages/doc-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/doc-generator",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Auto-Doc Generator — generate documentation from source code (RFC-0014)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/durable-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/durable-review",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "SQLite-backed durable reviewer using @earendil-works/pi-durable",
   "type": "module",
   "main": "src/index.ts",

package/packages/e2e-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/e2e-tester",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "WebMCP-powered E2E testing for pi-harness - natural language test scenarios",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/evaluation-engine",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Evaluation engine for pi-harness runtime (RFC-0057)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-runner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/evaluation-runner",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "Framework-agnostic evaluation framework for AI outputs (RFC-0020)",
   "main": "dist/index.js",

package/packages/event-bus/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-bus",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-sink/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/event-sink",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "Atomic event sourcing with SQLite transactions for pi-harness",
   "main": "./dist/index.js",

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/experience-replay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/experience-replay",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "description": "Experience replay for debugging and reproducibility (RFC-0059)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/feedback-collector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/feedback-collector",
-  "version": "1.1.404",
+  "version": "1.1.405",
   "type": "module",
   "description": "Collect and aggregate human/automated feedback (RFC-0021)",
   "main": "dist/index.js",