pi-harness-runtime 1.1.143 → 1.1.145

package/index.ts

@@ -69,6 +69,12 @@ import {
 	createBlackboard,
 } from "./harness/blackboard.ts";
 import { scheduleAutoResume, cancelAutoResume, getGLMQuotaCountdown } from "./harness/index.js";
+import { startWatcher, classifyMessage } from "./packages/codex-watcher/dist/src/index.js";
+import {
+	getPaperclipConfig,
+	hasPaperclipConfig,
+	PaperclipWatcher,
+} from "./packages/paperclip-integration/dist/index.js";
 
 // --- Jev Auto-Continue: Agent autonomous decision-making --------------------
 // Lazy import - only loads when packages/jev-judge exists and API key available
@@ -91,7 +97,7 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 			readFileSync(`${keysDir}/jev-api-key.txt`, "utf8").trim().length > 10;
 
 		if (!hasEnvKey && !hasFileKey) {
-			console.log(
+			console.error(
 				"[auto-continue] No Jev API key found. Set TYPESAFE_API_KEY run: echo \"{api_key}\" > ~/.pi-harness-runtime/keys/jev-api-key.txt"
 			);
 			return;
@@ -114,6 +120,11 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 			if (hasContinuation && !waitingForUserSince) {
 				waitingForUserSince = new Date();
 				console.log("[auto-continue] Agent waiting for continuation confirmation");
+				// Emit WaitingForUserInput to Telegram so user knows to respond
+				nc("WaitingForUserInput", {
+					requirement: "Agent awaiting your response",
+					error: "Continue / proceed confirmation needed",
+				});
 			}
 		});
 
@@ -188,7 +199,7 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 		// Start periodic check
 		setInterval(checkAndAutoContinue, AUTO_CONTINUE_INTERVAL_MS);
 
-		console.log("[auto-continue] Jev Auto-Continue initialized");
+		console.error("[auto-continue] Jev Auto-Continue initialized");
 	} catch {
 		// auto-continue not available
 	}
@@ -255,11 +266,12 @@ async function initTelegram(): Promise<void> {
 		const chatIdPath = `${keysDir}/telegram-chat-id.txt`;
 
 		if (!existsSync(botTokenPath) || !existsSync(chatIdPath)) {
-			logStartup("[pi-harness] Telegram notifications not configured:");
-			logStartup(`[pi-harness]   bot-token: create @BotFather bot → get token`);
-			logStartup(`[pi-harness]   chat-id:  message @userinfobot → reply shows your ID`);
-			logStartup(`[pi-harness]   echo "{bot-token}" > ~/.pi-harness-runtime/keys/telegram-bot-token.txt`);
-			logStartup(`[pi-harness]   echo "{chat-id}" > ~/.pi-harness-runtime/keys/telegram-chat-id.txt`);
+			logStartup("[pi-harness] Telegram (@PiHarnessRuntimeBot) not configured:");
+			logStartup("[pi-harness]   1. DM @BotFather → /newbot → name it → get token");
+			logStartup("[pi-harness]   2. DM @userinfobot → reply shows your chat ID");
+			logStartup("[pi-harness]   3. echo \"{token}\" > ~/.pi-harness-runtime/keys/telegram-bot-token.txt");
+			logStartup("[pi-harness]   4. echo \"{chat-id}\" > ~/.pi-harness-runtime/keys/telegram-chat-id.txt");
+			logStartup("[pi-harness]   5. Reload pi — then DM @PiHarnessRuntimeBot to verify");
 			return;
 		}
 
@@ -289,12 +301,26 @@ async function initTelegram(): Promise<void> {
 			return;
 		}
 
-		// Wire to GLMQuotaCountdown so it can send Telegram alerts on quota pauses
+		// Wire to singleton nc() helper so all event emitters can reach Telegram
+		_nc = {
+			center,
+			notify: (event: string, ctx: Record<string, unknown>) =>
+				center.notify(event as never, ctx as never),
+		};
+
+		// Wire to GLMQuotaCountdown so it sends Telegram alerts
 		try {
 			const { getGLMQuotaCountdown } = await import("./harness/index.js");
 			getGLMQuotaCountdown().setNotificationCenter(center);
 		} catch { /* not critical */ }
-		logStartup(`[pi-harness] Telegram notifications ready`);
+
+		// Log the actual bot username (fetched from Telegram API via getMe)
+		const botUsername = center.getTelegramBotUsername();
+		if (botUsername) {
+			logStartup(`[pi-harness] Telegram (@${botUsername}) ready — DM the bot to receive alerts`);
+		} else {
+			logStartup(`[pi-harness] Telegram notifications ready`);
+		}
 	} catch (err) {
 		logStartup("[pi-harness] Telegram: init failed:", err instanceof Error ? err.message : String(err));
 	}
@@ -812,6 +838,7 @@ function logStartup(...parts: string[]): void {
 
 interface HarnessSession {
 	jobId: string;
+	requirement: string;
 	machine: JobStateMachine;
 	graph: TaskGraphManager;
 	blackboard: SharedBlackboard;
@@ -821,6 +848,23 @@ interface HarnessSession {
 
 let currentSession: HarnessSession | null = null;
 
+/** Singleton notification center — set by initTelegram(), used by all emit helpers */
+let _nc: { center: unknown; notify: (event: string, ctx: Record<string, unknown>) => Promise<unknown> } | null = null;
+
+/**
+ * Fire a Telegram notification event. Silently skips if Telegram is not configured.
+ */
+async function nc(event: string, ctx: Record<string, unknown>): Promise<void> {
+	if (!_nc) return;
+	try {
+		await (_nc as { notify: (e: string, c: Record<string, unknown>) => Promise<void> }).notify(event, ctx);
+	} catch {
+		// Never crash runtime on notification failure
+	}
+}
+
+
+
 /**
  * Safely extract a text view from an LLM message. Used to feed the TUI
  * quota-signal extractor. Handles string content, array-of-parts content
@@ -1011,6 +1055,68 @@ export default function (pi: ExtensionAPI) {
 	// --- telegram-notifications: Telegram bot for harness event notifications ----
 	void initTelegram();
 
+	// --- codex-watcher: Inject Codex plans into pi.dev + Telegram --------------
+	// Lightweight: polls ~/.codex/sessions/ every 5s, no LangChain daemon.
+	// On plan detected: sends Telegram alert + steer message to pi.dev.
+	try {
+		let latestCodexSession = "";
+		let latestPlanOrdinal = 0;
+
+		const codexHandle = startWatcher({
+			pollIntervalMs: 5000,
+			maxIdlePolls: Infinity,
+			onSessionChange: (session) => {
+				if (session) {
+					latestCodexSession = session.id;
+					console.error(`[codex] Session started: ${session.threadName}`);
+					nc("CodexSessionStarted", {
+						requirement: session.threadName || "Codex session",
+						taskTitle: session.id,
+					});
+				}
+			},
+			onMessages: (msgs) => {
+				for (const msg of msgs) {
+					// Skip user messages — only track assistant plans
+					if (msg.role !== "assistant") continue;
+
+					const classification = classifyMessage(msg.text);
+					if (classification !== "plan" && classification !== "mixed") continue;
+					if (msg.ordinal <= latestPlanOrdinal) continue;
+
+					latestPlanOrdinal = msg.ordinal;
+
+					// Emit Telegram alert
+					nc("CodexPlanDetected", {
+						requirement: "Codex plan ready",
+						taskTitle: `Ordinal ${msg.ordinal}`,
+					});
+
+					// Inject plan into pi.dev as a steer message
+					const planPreview = msg.text.slice(0, 500) + (msg.text.length > 500 ? "
+..." : "");
+					try {
+						pi.sendUserMessage(
+							`[Codex plan detected — ordinal ${msg.ordinal}]
+
+${planPreview}`,
+							{ deliverAs: "steer" },
+						);
+					} catch {
+						// pi.dev may not be ready
+					}
+				}
+			},
+		});
+
+		// Clean up when pi session ends
+		pi.on("session_end", () => {
+			codexHandle.stop();
+		});
+	} catch {
+		// Codex watcher unavailable (e.g. no codex package installed)
+	}
+
 	// --- honcho-memory: Honcho MCP for peer/user memory (honcho_profile, etc.) ----
 	void initHoncho(pi);
 
@@ -1020,6 +1126,46 @@ export default function (pi: ExtensionAPI) {
 	// --- langchain-loop: Ping-pong write-review loop (planner + reviewer + coder) ----
 	void initLangChain(pi);
 
+	// --- paperclip: Watch Paperclip inbox, route tasks to pi.dev + Telegram ------------
+	// Only starts if PAPERCLIP_API_KEY is set or keys file exists.
+	if (hasPaperclipConfig()) {
+		const paperclipConfig = getPaperclipConfig();
+		if (paperclipConfig) {
+			const watcher = new PaperclipWatcher(paperclipConfig, {
+				nc,
+				sendUserMessage: (content, opts) => {
+					try {
+						pi.sendUserMessage(content, opts as { deliverAs: "steer" });
+					} catch {
+						// pi.dev may not be ready
+					}
+				},
+				pollIntervalMs: 30_000,
+				onRouted: async (issue) => {
+					// Mark task as in_progress in Paperclip
+					try {
+						const config = getPaperclipConfig();
+						if (config) {
+							const { PaperclipClient } = await import(
+								"./packages/paperclip-integration/dist/index.js"
+							);
+							const client = new PaperclipClient(config);
+							await client.updateIssueStatus(issue.id, "in_progress");
+						}
+					} catch {
+						// Non-critical
+					}
+				},
+			});
+			void watcher.start();
+			pi.on("session_end", () => watcher.stop());
+		}
+	} else {
+		console.error(
+			"[paperclip] Not configured. Set PAPERCLIP_API_KEY or write API key to ~/.pi-harness-runtime/keys/paperclip-api-key.txt",
+		);
+	}
+
 	// --- loop-completions: Watch daemon completions → agent TUI todos --------
 	void initLoopCompletions(pi);
 
@@ -1258,7 +1404,12 @@ Run \`bd ready\` to see current bd issues.
 			outputLimitResumeAttempts += 1;
 			pendingOutputLimitResumeAfterCompact = true;
 			pendingOutputLimitResumeAfterSettled = true;
-			queueAutoResume("output-limit", OUTPUT_LIMIT_RESUME_PROMPT, "steer");
+			await queueAutoResume("output-limit", OUTPUT_LIMIT_RESUME_PROMPT, "steer");
+			// Emit OutputLimitContinued to Telegram
+			await nc("OutputLimitContinued", {
+				requirement: "Session output",
+				error: `Attempt ${outputLimitResumeAttempts}`,
+			});
 		} else if (
 			shouldQueueProviderOverloadResume(
 				m,
@@ -2074,6 +2225,9 @@ Run \`bd ready\` to see current bd issues.
 					return;
 				}
 
+				// Emit JobStarted to Telegram
+				await nc("JobStarted", { requirement, jobId });
+
 				// Create task graph using heuristic planner
 				const planner = new MasterPlanner();
 				const planResult = await planner.createPlan(
@@ -2100,6 +2254,7 @@ Run \`bd ready\` to see current bd issues.
 				// Store session
 				currentSession = {
 					jobId,
+					requirement,
 					machine,
 					graph: createTaskGraphManager(),
 					blackboard,
@@ -2311,6 +2466,7 @@ Run \`bd ready\` to see current bd issues.
 			}
 
 			cancelAutoResume(currentSession.jobId);
+			await nc("JobCancelled", { requirement: currentSession.requirement });
 			const sessionJobId = currentSession.jobId;
 			currentSession = null;
 
@@ -2407,7 +2563,7 @@ Run \`bd ready\` to see current bd issues.
 				return;
 			}
 			pendingOutputLimitResumeAfterSettled = false;
-			queueAutoResume(
+			void queueAutoResume(
 				"output-limit-settled",
 				OUTPUT_LIMIT_RESUME_PROMPT,
 				"followUp",
@@ -2415,7 +2571,7 @@ Run \`bd ready\` to see current bd issues.
 		}, 0);
 	});
 
-	pi.on("session_compact", (event, ctx) => {
+	pi.on("session_compact", async (event, ctx) => {
 		// Capture only the setStatus function, not the ctx
 		footerSetStatus = ctx.ui.setStatus.bind(ctx.ui);
 		proactiveCompactInFlight = false;
@@ -2442,7 +2598,7 @@ Run \`bd ready\` to see current bd issues.
 		}
 
 		if (forceOutputLimitResume) {
-			queueAutoResume(
+			await queueAutoResume(
 				"post-compact-output-limit",
 				OUTPUT_LIMIT_RESUME_PROMPT,
 				event.willRetry ? "steer" : "followUp",
@@ -2452,7 +2608,7 @@ Run \`bd ready\` to see current bd issues.
 
 		outputLimitResumeAttempts = 0;
 		// pi.dev expects the literal "resume" command to continue after compaction.
-		queueAutoResume("post-compact", "resume", "followUp");
+		await queueAutoResume("post-compact", "resume", "followUp");
 	});
 
 	// --- Periodic quota refresh every 15 minutes ---
@@ -2495,7 +2651,7 @@ Run \`bd ready\` to see current bd issues.
 				console.error(`[pi-harness] Resume skipped: hasPendingMessages=true`);
 				return;
 			}
-			queueAutoResume(
+			void queueAutoResume(
 				"provider-overload",
 				PROVIDER_OVERLOAD_RESUME_PROMPT,
 				"followUp",
@@ -2503,13 +2659,17 @@ Run \`bd ready\` to see current bd issues.
 		}, delayMs);
 	}
 
-	function queueAutoResume(
+	async function queueAutoResume(
 		reason: string,
 		content: string,
 		deliverAs: "steer" | "followUp",
-	): void {
+	): Promise<void> {
 		try {
 			pi.sendUserMessage(content, { deliverAs });
+			await nc("ResumeScheduled", {
+				requirement: "Session auto-resume",
+				error: reason,
+			});
 		} catch (error) {
 			console.error(
 				`[pi-harness] Failed to queue ${reason} auto-resume:`,
@@ -2553,6 +2713,11 @@ Run \`bd ready\` to see current bd issues.
 				lastProactiveCompactAt = Date.now();
 				consecutiveCompactFailures = 0;
 				proactiveCompactCircuitReported = false;
+				// Emit ContextCompacted to Telegram
+				nc("ContextCompacted", {
+					requirement: "Session context",
+					error: "Proactive compact completed",
+				});
 			},
 			onError: (error) => {
 				proactiveCompactInFlight = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "type": "module",
   "description": "Google Agent-to-Agent (A2A) protocol adapter for pi-harness",
   "main": "dist/index.js",

package/packages/architecture-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/architecture-generator",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "description": "Auto-capture API-fetched configuration values to AGENTS.md",
   "type": "module",
   "main": "src/index.ts",

package/packages/context-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-compiler",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "description": "Context Window Manager — prevents model context overflow via compaction and resume prompts (RFC-0010)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cookie-sanitizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cookie-sanitizer",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "description": "Auto-Doc Generator — generate documentation from source code (RFC-0014)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/evaluation-engine",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "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.143",
+  "version": "1.1.145",
   "type": "module",
   "description": "Collect and aggregate human/automated feedback (RFC-0021)",
   "main": "dist/index.js",

package/packages/file-copy-helper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/file-copy-helper",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "description": "Injects cp/sudo cp rule when user asks to mimic/copy files",
   "type": "module",
   "main": "dist/index.js",

package/packages/framework-detector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/framework-detector",
-  "version": "1.1.143",
+  "version": "1.1.145",
   "description": "Framework detection system for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",