pi-harness-runtime 1.1.44 → 1.1.45

package/harness/langchain/status-line.ts

@@ -0,0 +1,255 @@
+/**
+ * Status line manager — drives the harness loop status in the pi host.
+ *
+ * Architecture:
+ *
+ *   Pi-lens installed?
+ *   ├─ YES → LoopWidget.makeRenderer() → pi host's ui.setWidget("harness-loop", ...)
+ *   └─ NO  → write to .harness-status → pi host reads and displays
+ *
+ * The status line shows two tiers of information:
+ *   [loop status]  [API quota]
+ *   🧭 planning   MiniMax: 5h: 89% left · week: 90% left
+ *
+ * API quota is read from ~/.pi-harness/quota.json (written by the pi host
+ * process that has access to the TUI quota signals).  The daemon polls this
+ * file every 60s so the status line stays fresh even when no task is running.
+ *
+ * Wiki: wiki/pi-lens-status-line.md
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+
+// ─── Quota types ─────────────────────────────────────────────────────────────
+
+export interface QuotaData {
+	/** MiniMax 5-hour window usage percentage (0–100). Undefined = unknown. */
+	fiveHourPercent?: number;
+	/** MiniMax weekly window usage percentage (0–100). Undefined = unknown. */
+	weeklyPercent?: number;
+	/** ISO timestamp of when the 5-hour quota resets. */
+	fiveHourResetAt?: string;
+	/** ISO timestamp of when the weekly quota resets. */
+	weeklyResetAt?: string;
+	/** Raw message from GLM quota signal (for display) */
+	rawMessage?: string;
+}
+
+interface QuotaFile {
+	miniMax?: {
+		fiveHour?: { percent?: number; resetAt?: string };
+		weekly?: { percent?: number; resetAt?: string };
+	};
+	updatedAt?: string;
+}
+
+// ─── Detection ───────────────────────────────────────────────────────────────
+
+/** True when the daemon is running inside a pi-lens-equipped pi host. */
+export function isPiLensAvailable(): boolean {
+	return (
+		Boolean(process.env.PI_LENS_PID) ||
+		Boolean(process.env.PI_LENS_SOCKET) ||
+		process.env.PI_LENS === "1"
+	);
+}
+
+// ─── Status line format ──────────────────────────────────────────────────────
+
+/**
+ * Format a quota percentage for display.
+ * Shows "N% left" when known, "?" when unknown.
+ */
+function fmtPercent(p?: number): string {
+	if (p === undefined || p < 0) return "?";
+	if (p >= 100) return "0% left";
+	return `${p}% left`;
+}
+
+/**
+ * Format an ISO reset timestamp as a human-readable countdown.
+ * "in 2h 30m", "in 45m", "at 19:17", etc.
+ */
+function fmtResetAt(iso?: string): string {
+	if (!iso) return "";
+	try {
+		const reset = new Date(iso);
+		if (isNaN(reset.getTime())) return "";
+		const now = new Date();
+		const diffMs = reset.getTime() - now.getTime();
+		if (diffMs <= 0) return " (resetting soon)";
+		const mins = Math.floor(diffMs / 60_000);
+		const hours = Math.floor(mins / 60);
+		const remMins = mins % 60;
+		if (hours > 0) return ` (resets in ${hours}h ${remMins}m)`;
+		return ` (resets in ${remMins}m)`;
+	} catch {
+		return "";
+	}
+}
+
+/**
+ * Build a one-line status string.
+ * Format: "MiniMax: 5h: 89% left (resets in 2h) · week: 90% left"
+ */
+export function formatQuotaLine(q: QuotaData): string {
+	const fiveHour = q.fiveHourPercent === undefined
+		? null
+		: `5h: ${fmtPercent(q.fiveHourPercent)}${fmtResetAt(q.fiveHourResetAt)}`;
+	const weekly = q.weeklyPercent === undefined
+		? null
+		: `week: ${fmtPercent(q.weeklyPercent)}`;
+
+	const parts = [fiveHour, weekly].filter(Boolean);
+	if (parts.length === 0) return "MiniMax: quota unknown";
+	return `MiniMax: ${parts.join(" · ")}`;
+}
+
+// ─── StatusLineManager ───────────────────────────────────────────────────────
+
+/**
+ * Drives the harness status line in the pi host.
+ *
+ * - When pi-lens is available: provides the LoopWidget renderer factory
+ *   for the pi host to integrate via `ui.setWidget("harness-loop", factory)`.
+ * - When pi-lens is not available: writes a plain-text status to
+ *   `<workspace>/.harness-status` every time update() is called.
+ *
+ * The pi host can read `.harness-status` and display it in its own UI.
+ */
+export class StatusLineManager {
+	private readonly workspace: string;
+	private readonly quotaFile: string;
+	private lastQuota: QuotaData = {};
+	private timer?: ReturnType<typeof setInterval>;
+	private loopStatus = "";
+
+	constructor(workspace: string) {
+		this.workspace = workspace;
+		// Quota file written by the pi host (which has access to TUI signals)
+		this.quotaFile = join(homedir(), ".pi-harness", "quota.json");
+	}
+
+	// ─── Public API ──────────────────────────────────────────────────────────
+
+	/**
+	 * Start polling the quota file.
+	 * Call once after construction.
+	 */
+	start(): void {
+		this._pollQuota();
+		this.timer = setInterval(() => this._pollQuota(), 60_000);
+	}
+
+	/** Stop polling. */
+	stop(): void {
+		if (this.timer) {
+			clearInterval(this.timer);
+			this.timer = undefined;
+		}
+	}
+
+	/**
+	 * Update the loop status (planning/writing/reviewing/finished).
+	 * Call this from the daemon's onStep handler.
+	 */
+	updateLoopStatus(status: string): void {
+		this.loopStatus = status;
+		this._writeStatusFile();
+	}
+
+	/**
+	 * Update the full status — call after each loop transition.
+	 * Writes the status file (when no pi-lens) and logs to console.
+	 */
+	update(data: { loopStatus?: string; quota?: QuotaData }): void {
+		if (data.loopStatus !== undefined) this.loopStatus = data.loopStatus;
+		if (data.quota) this.lastQuota = data.quota;
+		this._writeStatusFile();
+	}
+
+	/**
+	 * Returns a rendered one-line status string for the pi host to display.
+	 * Combines loop status + quota into a single readable line.
+	 */
+	getLine(): string {
+		const quotaLine = formatQuotaLine(this.lastQuota);
+		if (this.loopStatus) {
+			return `${this.loopStatus}  |  ${quotaLine}`;
+		}
+		return quotaLine;
+	}
+
+	// ─── Internal ───────────────────────────────────────────────────────────
+
+	private _pollQuota(): void {
+		try {
+			if (!existsSync(this.quotaFile)) return;
+			const raw = readFileSync(this.quotaFile, "utf8");
+			const data = JSON.parse(raw) as QuotaFile;
+			if (data.miniMax) {
+				this.lastQuota = {
+					fiveHourPercent: data.miniMax.fiveHour?.percent,
+					fiveHourResetAt: data.miniMax.fiveHour?.resetAt,
+					weeklyPercent: data.miniMax.weekly?.percent,
+					weeklyResetAt: data.miniMax.weekly?.resetAt,
+					rawMessage: data.miniMax.fiveHour?.resetAt
+						? `5h quota resets at ${data.miniMax.fiveHour.resetAt}`
+						: undefined,
+				};
+				this._writeStatusFile();
+			}
+		} catch {
+			// Quota file missing or invalid — skip
+		}
+	}
+
+	private _writeStatusFile(): void {
+		if (isPiLensAvailable()) return; // pi-lens handles its own display
+
+		const line = this.getLine();
+		const statusFile = join(this.workspace, ".harness-status");
+		try {
+			// Ensure directory exists
+			const dir = dirname(statusFile);
+			if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+			writeFileSync(statusFile, line + "\n", "utf8");
+		} catch {
+			// Ignore write errors (read-only filesystem, etc.)
+		}
+	}
+}
+
+// ─── Quota file writer (for the pi host) ─────────────────────────────────────
+
+/**
+ * Write quota data to the shared quota file.
+ * Call this from the pi host process that receives GLM TUI signals.
+ *
+ * The daemon reads this file to keep its status line fresh.
+ */
+export function writeQuotaFile(data: QuotaData): void {
+	const dir = join(homedir(), ".pi-harness");
+	const file = join(dir, "quota.json");
+	try {
+		if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+		const payload: QuotaFile = {
+			miniMax: {
+				fiveHour: {
+					percent: data.fiveHourPercent,
+					resetAt: data.fiveHourResetAt,
+				},
+				weekly: {
+					percent: data.weeklyPercent,
+					resetAt: data.weeklyResetAt,
+				},
+			},
+			updatedAt: new Date().toISOString(),
+		};
+		writeFileSync(file, JSON.stringify(payload, null, 2), "utf8");
+	} catch {
+		// Ignore write errors
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "type": "module",
   "description": "OpenAI Codex provider adapter for pi-harness",
   "main": "dist/index.js",

package/packages/config-capture/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/config-capture",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "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.44",
+  "version": "1.1.45",
   "description": "Framework detection system for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

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

@@ -1,6 +1,6 @@
 {
   "name": "@pi/framework-plugin-sdk",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "description": "Framework plugin SDK for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/frappe-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/frappe-plugin",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "description": "Frappe/ERPNext framework analysis — DocTypes, hooks, bench sites, site config",
   "type": "module",
   "main": "./dist/index.js",

package/packages/generic-web-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/generic-web-plugin",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "description": "Generic web framework analysis — REST/GraphQL endpoints, OpenAPI, auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/health-monitor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/health-monitor",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "type": "module",
   "description": "Health monitoring and auto-healing",
   "main": "dist/index.js",

package/packages/intent-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/intent-analyzer",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/knowledge-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-graph",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "description": "Knowledge Graph extraction and provenance linking for SKILL.md files",
   "type": "module",
   "main": "./dist/index.js",

package/packages/knowledge-retrieval/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-retrieval",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "description": "Knowledge retrieval via TencentDB-Agent-Memory MCP (RFC-0105)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/laravel-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/laravel-plugin",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "description": "Laravel framework analysis — artisan commands, Eloquent models, Blade",
   "type": "module",
   "main": "./dist/index.js",

package/packages/learning-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/learning-engine",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "description": "Learning engine for extracting lessons from runtime execution (RFC-0058)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/mcp-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/mcp-adapter",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "type": "module",
   "description": "MCP server adapter for pi-harness — exposes harness capabilities as MCP tools/resources/prompts (RFC-0068)",
   "main": "dist/index.js",

package/packages/memory-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/memory-engine",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "description": "Memory engine with OKF integration for durable knowledge management (RFC-0060)",
   "type": "module",
   "main": "./dist/index.js",