pi-harness-runtime 1.1.15 → 1.1.16

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.1.16](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v1.1.13...v1.1.16) (2026-08-24)
+
+
+### Features
+
+* **glm-quota:** add robust GLM quota countdown with auto-resume ([cb78a2b](https://github.com/ManotLuijiu/pi-harness-runtime/commit/cb78a2bdf5ecf79fc028030d43e3ce40767253cb))
+* **glm:** add structured logging for GLM quota events ([09e692e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/09e692ec17b9c21a448c72f081d18fb35b8636ae))
+
+
+### Bug Fixes
+
+* **glm:** improve footer status display with specific 5h quota and reset time ([ab991c3](https://github.com/ManotLuijiu/pi-harness-runtime/commit/ab991c329bdb4097e77503d3d7f574edc6cdc1c4))
+
 ### [1.1.15](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v1.1.13...v1.1.15) (2026-08-24)
 
 

package/footer-status.ts

@@ -235,7 +235,10 @@ export function buildFooterStatusValue(
 			view.resets_at !== undefined ||
 			view.h5_resets_at !== undefined)
 	) {
-		const limitTypeLabel = getLimitTypeLabel(provider, view.limitType ?? undefined);
+		const limitTypeLabel = getLimitTypeLabel(
+			provider,
+			view.limitType ?? undefined,
+		);
 		const resetFormatted = formatResetTime(view.resets_at ?? view.h5_resets_at);
 		return `${label}: ${limitTypeLabel} hit, resets ${resetFormatted}`;
 	}

package/harness/e2e/glm-quota-scraper.ts

@@ -143,7 +143,8 @@ export class GLMQuotaScraper {
 
 	constructor(config: GLMScraperConfig = {}) {
 		// Resolve API key: direct value > file > null
-		const apiKey = config.apiKey ?? loadApiKey(config.apiKeyFile ?? DEFAULT_API_KEY_FILE);
+		const apiKey =
+			config.apiKey ?? loadApiKey(config.apiKeyFile ?? DEFAULT_API_KEY_FILE);
 
 		this.config = {
 			apiKeyFile: config.apiKeyFile ?? DEFAULT_API_KEY_FILE,
@@ -191,13 +192,16 @@ export class GLMQuotaScraper {
 	/**
 	 * Fetch usage data from z.ai API
 	 */
-	async fetchUsage(startDate?: Date, endDate?: Date): Promise<GLMQuotaData | null> {
+	async fetchUsage(
+		startDate?: Date,
+		endDate?: Date,
+	): Promise<GLMQuotaData | null> {
 		const apiKey = this.getApiKey();
 		if (!apiKey) {
 			if (!this.config.quiet) {
 				console.error(
 					`[DEBUG GLMQuotaScraper] No API key found. ` +
-					`Set ZAI_API_KEY env var or drop key into ${DEFAULT_API_KEY_FILE}`,
+						`Set ZAI_API_KEY env var or drop key into ${DEFAULT_API_KEY_FILE}`,
 				);
 			}
 			return null;
@@ -214,7 +218,9 @@ export class GLMQuotaScraper {
 
 		try {
 			if (!this.config.quiet) {
-				console.log(`[DEBUG GLMQuotaScraper] Fetching usage from ${startStr} to ${endStr}`);
+				console.log(
+					`[DEBUG GLMQuotaScraper] Fetching usage from ${startStr} to ${endStr}`,
+				);
 			}
 
 			const response = await fetch(url, {
@@ -234,7 +240,7 @@ export class GLMQuotaScraper {
 				return null;
 			}
 
-			const data = await response.json() as {
+			const data = (await response.json()) as {
 				code?: number;
 				success?: boolean;
 				data?: {
@@ -255,7 +261,9 @@ export class GLMQuotaScraper {
 
 			if (!data.success || !data.data) {
 				if (!this.config.quiet) {
-					console.error(`[DEBUG GLMQuotaScraper] API error: ${data.msg ?? "Unknown error"}`);
+					console.error(
+						`[DEBUG GLMQuotaScraper] API error: ${data.msg ?? "Unknown error"}`,
+					);
 				}
 				return null;
 			}
@@ -279,8 +287,8 @@ export class GLMQuotaScraper {
 			if (!this.config.quiet) {
 				console.log(
 					`[DEBUG GLMQuotaScraper] Total calls: ${result.totalCalls}, ` +
-					`Total tokens: ${result.totalTokens.toLocaleString()}, ` +
-					`Model: ${result.modelName}`,
+						`Total tokens: ${result.totalTokens.toLocaleString()}, ` +
+						`Model: ${result.modelName}`,
 				);
 			}
 
@@ -320,7 +328,7 @@ export class GLMQuotaScraper {
 				return null;
 			}
 
-			const data = await response.json() as {
+			const data = (await response.json()) as {
 				code?: number;
 				success?: boolean;
 				data?: Array<{
@@ -479,7 +487,7 @@ export class GLMQuotaManager {
 			return this.lastQuota;
 		}
 
-		this.lastQuota = await this.scraper.fetchUsage() ?? undefined;
+		this.lastQuota = (await this.scraper.fetchUsage()) ?? undefined;
 		this.lastFetchTime = now;
 		return this.lastQuota ?? null;
 	}

package/harness/glm-quota-countdown.ts

@@ -21,6 +21,24 @@ import type { JobStateMachine } from "./job-state-machine.js";
 import type { MirrorStore } from "../mirror.js";
 import type { NotificationCenter } from "../packages/notification/dist/notification-center.js";
 
+import {
+	logInfo,
+	logWarn,
+	logError,
+	logCountdownStarted,
+	logCountdownTick,
+	logCountdownComplete,
+	logAutoResumeSuccess,
+	logAutoResumeFailed,
+	logNotificationSent,
+	logNotificationFailed,
+	logMirrorUpdate,
+	logQuotaExhausted,
+	logCountdownCancelled,
+	logResetTimeParseError,
+	getLogFilePath,
+} from "./glm-quota-logger.js";
+
 /** Notification intervals before reset (in seconds) */
 const NOTIFICATION_INTERVALS = [
 	15 * 60, // 15 minutes
@@ -245,9 +263,7 @@ export class GLMQuotaCountdown {
 			isResetTime: totalSeconds <= 0,
 		});
 
-		console.log(
-			`[GLMQuotaCountdown] Started countdown for job ${jobId}: ${formatCountdown(totalSeconds)} until reset at ${resetAt}`,
-		);
+		logCountdownStarted(jobId, resetAt, totalSeconds);
 
 		return state;
 	}
@@ -263,9 +279,7 @@ export class GLMQuotaCountdown {
 	): Promise<GLMQuotaCountdownState | null> {
 		const resetAt = parseGLMResetTime(errorMessage);
 		if (!resetAt) {
-			console.warn(
-				`[GLMQuotaCountdown] Could not parse reset time from error for job ${jobId}`,
-			);
+			logResetTimeParseError(jobId);
 			return null;
 		}
 
@@ -282,7 +296,7 @@ export class GLMQuotaCountdown {
 			this.timers.delete(jobId);
 		}
 		this.activeCountdowns.delete(jobId);
-		console.log(`[GLMQuotaCountdown] Cancelled countdown for job ${jobId}`);
+		logCountdownCancelled(jobId);
 	}
 
 	/**
@@ -322,11 +336,10 @@ export class GLMQuotaCountdown {
 			};
 
 			mirrorStore.writeProvider("glm", updated);
-			console.log(
-				`[GLMQuotaCountdown] Updated mirror with reset time: ${resetAt}`,
-			);
+			logMirrorUpdate(jobId, true);
 		} catch (error) {
-			console.error(`[GLMQuotaCountdown] Failed to update mirror: ${error}`);
+			logMirrorUpdate(jobId, false);
+			logError(jobId, "Failed to update mirror", error);
 		}
 	}
 
@@ -476,7 +489,7 @@ export class GLMQuotaCountdown {
 	 * Get seconds until next notification
 	 */
 	private getNextNotificationIn(
-		state: GLMQuotaCountdownState,
+		_state: GLMQuotaCountdownState,
 		remainingSeconds: number,
 	): number | undefined {
 		for (const interval of NOTIFICATION_INTERVALS) {
@@ -496,13 +509,13 @@ export class GLMQuotaCountdown {
 		interval: number,
 	): Promise<void> {
 		if (!this.notificationCenter) {
-			console.log(
-				`[GLMQuotaCountdown] Notification: ${formatCountdown(remainingSeconds)} until GLM quota reset`,
+			logInfo(
+				jobId,
+				`Notification: ${formatCountdown(remainingSeconds)} until GLM quota reset`,
 			);
 			return;
 		}
 
-		const minutes = Math.floor(remainingSeconds / 60);
 		const label =
 			interval === 15 * 60
 				? "15 minutes"
@@ -516,11 +529,9 @@ export class GLMQuotaCountdown {
 				requirement: this.jobContext?.requirement ?? "GLM Quota",
 				error: `GLM quota reset in ${label} (${formatCountdown(remainingSeconds)}). Auto-resume pending.`,
 			});
-			console.log(
-				`[GLMQuotaCountdown] Sent ${label} notification for job ${jobId}`,
-			);
+			logNotificationSent(jobId, remainingSeconds);
 		} catch (error) {
-			console.error(`[GLMQuotaCountdown] Failed to send notification: ${error}`);
+			logNotificationFailed(jobId, String(error));
 		}
 	}
 
@@ -529,11 +540,11 @@ export class GLMQuotaCountdown {
 	 */
 	private async triggerAutoResume(
 		jobId: string,
-		state: GLMQuotaCountdownState,
+		_state: GLMQuotaCountdownState,
 		machine: JobStateMachine,
 		mirrorStore: MirrorStore,
 	): Promise<void> {
-		console.log(`[GLMQuotaCountdown] Triggering auto-resume for job ${jobId}`);
+		logCountdownComplete(jobId);
 
 		// Clear timers
 		this.cancelCountdown(jobId);
@@ -547,7 +558,7 @@ export class GLMQuotaCountdown {
 			if (checkpoint && checkpoint.status === "paused_quota") {
 				const result = await machine.transition("running");
 				if (result.success) {
-					console.log(`[GLMQuotaCountdown] Job ${jobId} auto-resumed successfully`);
+					logAutoResumeSuccess(jobId);
 
 					// Update mirror to clear exhaustion
 					const record = mirrorStore.readProvider("glm");
@@ -569,11 +580,11 @@ export class GLMQuotaCountdown {
 						isResetTime: true,
 					});
 				} else {
-					console.error(`[GLMQuotaCountdown] Auto-resume failed: ${result.error}`);
+					logAutoResumeFailed(jobId, result.error ?? "Unknown error");
 				}
 			}
 		} catch (error) {
-			console.error(`[GLMQuotaCountdown] Auto-resume error: ${error}`);
+			logError(jobId, "Auto-resume error", error);
 		}
 	}
 
@@ -585,7 +596,7 @@ export class GLMQuotaCountdown {
 			try {
 				callback(event);
 			} catch (error) {
-				console.error(`[GLMQuotaCountdown] Tick callback error: ${error}`);
+				logError(event.jobId, "Tick callback error", error);
 			}
 		}
 	}

package/harness/glm-quota-logger.ts

@@ -0,0 +1,172 @@
+/**
+ * GLM Quota Logger — Structured logging for GLM quota events
+ *
+ * Logs are written to:
+ *   ~/.pi/harness-logs/glm-quota.log
+ *
+ * Log levels:
+ *   INFO  - Normal events (countdown started, resume triggered)
+ *   WARN  - Warnings (quota still exhausted, notification failed)
+ *   ERROR - Errors (auto-resume failed, mirror update failed)
+ *
+ * Format: [ISO_TIMESTAMP] [LEVEL] [jobId] message
+ */
+
+import { appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+export type LogLevel = "INFO" | "WARN" | "ERROR";
+
+const LOG_DIR = join(homedir(), ".pi", "harness-logs");
+const LOG_FILE = join(LOG_DIR, "glm-quota.log");
+
+/** Ensure log directory exists */
+function ensureLogDir(): void {
+	if (!existsSync(LOG_DIR)) {
+		mkdirSync(LOG_DIR, { recursive: true });
+	}
+}
+
+/** Format log entry */
+function formatLog(level: LogLevel, jobId: string | null, message: string): string {
+	const timestamp = new Date().toISOString();
+	const job = jobId ? `[${jobId}]` : "[system]";
+	return `[${timestamp}] [${level}] ${job} ${message}`;
+}
+
+/**
+ * Write a log entry to file
+ */
+function writeLog(level: LogLevel, jobId: string | null, message: string): void {
+	try {
+		ensureLogDir();
+		const entry = formatLog(level, jobId, message) + "\n";
+		appendFileSync(LOG_FILE, entry);
+	} catch {
+		// Non-fatal - just log to console
+		console.error(`[GLMQuotaLogger] Failed to write log: ${message}`);
+	}
+}
+
+// --- Public API ---
+
+/**
+ * Log info level event
+ */
+export function logInfo(jobId: string | null, message: string): void {
+	console.log(`[GLMQuota] ${jobId ? `[${jobId}] ` : ""}${message}`);
+	writeLog("INFO", jobId, message);
+}
+
+/**
+ * Log warning level event
+ */
+export function logWarn(jobId: string | null, message: string): void {
+	console.warn(`[GLMQuota] ${jobId ? `[${jobId}] ` : ""}${message}`);
+	writeLog("WARN", jobId, message);
+}
+
+/**
+ * Log error level event
+ */
+export function logError(jobId: string | null, message: string, error?: unknown): void {
+	const errorMsg = error instanceof Error ? error.message : String(error ?? "");
+	const fullMessage = errorMsg ? `${message}: ${errorMsg}` : message;
+	console.error(`[GLMQuota] ${jobId ? `[${jobId}] ` : ""}${fullMessage}`);
+	writeLog("ERROR", jobId, fullMessage);
+}
+
+// --- Event-specific log helpers ---
+
+/** Log countdown started */
+export function logCountdownStarted(
+	jobId: string,
+	resetAt: string,
+	totalSeconds: number,
+): void {
+	const hours = Math.floor(totalSeconds / 3600);
+	const minutes = Math.floor((totalSeconds % 3600) / 60);
+	logInfo(
+		jobId,
+		`Countdown started: ${hours}h ${minutes}m until ${resetAt}`,
+	);
+}
+
+/** Log countdown tick */
+export function logCountdownTick(
+	jobId: string,
+	remainingSeconds: number,
+): void {
+	const hours = Math.floor(remainingSeconds / 3600);
+	const minutes = Math.floor((remainingSeconds % 3600) / 60);
+	const secs = remainingSeconds % 60;
+	logInfo(
+		jobId,
+		`Countdown tick: ${hours}h ${minutes}m ${secs}s remaining`,
+	);
+}
+
+/** Log countdown completed */
+export function logCountdownComplete(jobId: string): void {
+	logInfo(jobId, "Countdown complete, triggering auto-resume");
+}
+
+/** Log auto-resume success */
+export function logAutoResumeSuccess(jobId: string): void {
+	logInfo(jobId, "Auto-resume succeeded, job resumed");
+}
+
+/** Log auto-resume failed */
+export function logAutoResumeFailed(jobId: string, error: string): void {
+	logError(jobId, "Auto-resume failed", error);
+}
+
+/** Log notification sent */
+export function logNotificationSent(
+	jobId: string,
+	beforeReset: number,
+): void {
+	const minutes = Math.floor(beforeReset / 60);
+	logInfo(jobId, `Notification sent: ${minutes} minutes before reset`);
+}
+
+/** Log notification failed */
+export function logNotificationFailed(
+	jobId: string,
+	error: string,
+): void {
+	logWarn(jobId, `Notification failed: ${error}`);
+}
+
+/** Log mirror update */
+export function logMirrorUpdate(jobId: string, success: boolean): void {
+	if (success) {
+		logInfo(jobId, "Mirror store updated with reset time");
+	} else {
+		logWarn(jobId, "Failed to update mirror store");
+	}
+}
+
+/** Log quota exhaustion detected */
+export function logQuotaExhausted(
+	jobId: string,
+	resetAt: string,
+): void {
+	logInfo(jobId, `GLM 5h quota exhausted, reset at ${resetAt}`);
+}
+
+/** Log countdown cancelled */
+export function logCountdownCancelled(jobId: string): void {
+	logInfo(jobId, "Countdown cancelled");
+}
+
+/** Log error parsing reset time */
+export function logResetTimeParseError(jobId: string): void {
+	logWarn(jobId, "Could not parse reset time from error message");
+}
+
+/** Get the log file path */
+export function getLogFilePath(): string {
+	return LOG_FILE;
+}

package/harness/index.ts

@@ -222,6 +222,25 @@ export type {
 	CountdownTickEvent,
 } from "./glm-quota-countdown.js";
 
+// --- GLM Quota Logger ---------------------------------------------
+export {
+	logInfo,
+	logWarn,
+	logError,
+	logCountdownStarted,
+	logCountdownTick,
+	logCountdownComplete,
+	logAutoResumeSuccess,
+	logAutoResumeFailed,
+	logNotificationSent,
+	logNotificationFailed,
+	logMirrorUpdate,
+	logQuotaExhausted,
+	logCountdownCancelled,
+	logResetTimeParseError,
+	getLogFilePath,
+} from "./glm-quota-logger.js";
+
 // --- RFC-0059: Experience Replay ------------------------------------------
 export {
 	ExperienceReplay,

package/package.json

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

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.14",
+  "version": "1.1.15",
   "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.14",
+  "version": "1.1.15",
   "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.14",
+  "version": "1.1.15",
   "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.14",
+  "version": "1.1.15",
   "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.14",
+  "version": "1.1.15",
   "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.14",
+  "version": "1.1.15",
   "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.14",
+  "version": "1.1.15",
   "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.14",
+  "version": "1.1.15",
   "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.14",
+  "version": "1.1.15",
   "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.14",
+  "version": "1.1.15",
   "type": "module",
   "main": "src/index.ts",
   "exports": {