pi-harness-runtime 1.1.252 → 1.1.255

package/packages/codex-watcher/src/index.ts

@@ -18,7 +18,7 @@
  *   // later: handle.stop();
  */
 
-import { existsSync, openSync, readFileSync, statSync } from "node:fs";
+import { existsSync, openSync, readFileSync, readSync, fstatSync, closeSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { classifyMessage, parseNewMessages } from "./parser.js";
@@ -75,6 +75,7 @@ export async function getVisibleMessages(
  * 1. Polls session_index.jsonl to detect active session changes
  * 2. Tracks file position so it only reads new lines (no re-read of full file)
  * 3. Calls onMessages with incremental messages each poll cycle
+ * 4. Preserves incomplete JSON lines until a complete newline-delimited record arrives
  */
 export function startWatcher(options: WatcherOptions = {}): WatcherHandle {
 	const {
@@ -89,6 +90,8 @@ export function startWatcher(options: WatcherOptions = {}): WatcherHandle {
 	let currentFd: ReturnType<typeof openSync> | null = null;
 	let currentPath: string | null = null;
 	let currentOrdinal = 0;
+	let currentBytePos = 0;  // Track byte position we're at in the file
+	let pendingBytes: Buffer | null = null;  // Raw bytes buffer for UTF-8 safety
 	let pollCount = 0;
 	const maxIdlePolls = options.maxIdlePolls ?? Infinity;
 
@@ -99,11 +102,11 @@ export function startWatcher(options: WatcherOptions = {}): WatcherHandle {
 		stopped = true;
 		if (currentFd !== null) {
 			try {
-				const { closeSync } = require("node:fs") as typeof import("node:fs");
 				closeSync(currentFd);
 			} catch {
 				// ignore
 			}
+			currentFd = null;
 		}
 	}
 
@@ -122,43 +125,76 @@ export function startWatcher(options: WatcherOptions = {}): WatcherHandle {
 	function openRollout(path: string) {
 		if (currentFd !== null && currentPath !== path) {
 			try {
-				const { closeSync } = require("node:fs") as typeof import("node:fs");
 				closeSync(currentFd);
 			} catch {
 				// ignore
 			}
+			currentFd = null;
 		}
 
-		// stat to get current size
-		const stat = statSync(path);
+		// Open the file for reading
 		currentFd = openSync(path, "r");
 		currentPath = path;
 		currentOrdinal = 0;
-		return { fd: currentFd, size: stat.size };
+		currentBytePos = 0;
+		pendingBytes = null;  // Reset pending buffer for new file
+		return currentFd;
 	}
 
+	/**
+	 * Read new lines from the file, preserving incomplete records.
+	 * Uses raw byte buffering to safely handle UTF-8 split across reads.
+	 * Returns complete lines only; incomplete trailing data is kept for next read.
+	 */
 	function readNewLines(
 		fd: number,
-		knownSize: number,
 	): {
 		lines: string[];
-		newSize: number;
+		newBytePos: number;
 	} {
-		const { readSync, fstatSync } =
-			require("node:fs") as typeof import("node:fs");
 		const stat = fstatSync(fd);
-		const newSize = stat.size;
+		const fileSize = stat.size;
 
-		if (newSize <= knownSize) {
-			return { lines: [], newSize: knownSize };
+		// Read from our tracked position to current end of file
+		const bytesToRead = fileSize - currentBytePos;
+		if (bytesToRead <= 0) {
+			return { lines: [], newBytePos: currentBytePos };
 		}
 
-		const buf = Buffer.alloc(newSize - knownSize);
-		const bytesRead = readSync(fd, buf, 0, buf.length, knownSize);
-		const text = buf.subarray(0, bytesRead).toString("utf8");
-		const lines = text.split("\n").filter((l) => l.trim());
+		const buf = Buffer.alloc(bytesToRead);
+		const bytesRead = readSync(fd, buf, 0, buf.length, currentBytePos);
 
-		return { lines, newSize };
+		// Buffer raw bytes for UTF-8 safety
+		if (pendingBytes) {
+			// Combine with previous incomplete buffer
+			const combined = Buffer.concat([pendingBytes, buf.subarray(0, bytesRead)]);
+			pendingBytes = combined;
+		} else {
+			pendingBytes = buf.subarray(0, bytesRead);
+		}
+
+		// Decode the complete buffer
+		const text = pendingBytes.toString("utf8");
+
+		// Split by newline to find complete records
+		const lines = text.split("\n");
+
+		// If buffer doesn't end with newline, last element is incomplete
+		if (!pendingBytes.toString("utf8").endsWith("\n")) {
+			// Keep the incomplete line for next read (already in pendingBytes)
+			return { lines: [], newBytePos: currentBytePos };
+		}
+
+		// All lines are complete - emit them and clear buffer
+		pendingBytes = null;
+
+		// Filter out empty lines
+		const completeLines = lines.filter((l) => l.trim());
+
+		// Update our tracked position by bytes actually read
+		const newBytePos = currentBytePos + bytesRead;
+
+		return { lines: completeLines, newBytePos };
 	}
 
 	async function poll() {
@@ -198,8 +234,9 @@ export function startWatcher(options: WatcherOptions = {}): WatcherHandle {
 				return;
 			}
 
-			const stat = statSync(session.rolloutPath);
-			const { lines } = readNewLines(currentFd, stat.size);
+			// Read new lines from our tracked byte position
+			const { lines, newBytePos } = readNewLines(currentFd!);
+			currentBytePos = newBytePos;  // Update tracked position
 
 			if (lines.length > 0) {
 				pollCount = 0;

package/packages/codex-watcher/src/session.ts

@@ -2,7 +2,7 @@
  * Session discovery — reads ~/.codex/session_index.jsonl to find active sessions.
  */
 
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import type { CodexSession } from "./types.js";
@@ -69,51 +69,38 @@ function findRolloutPath(sessionId: string, codexDir?: string): string {
 	// The rollout path follows: sessions/YYYY/MM/DD/rollout-YYYY-MM-DDTHH-MM-SS-<sessionId>.jsonl
 	// We need to find the file whose name ends with <sessionId>.jsonl
 	// Since there can be multiple sessions per day, iterate all files.
-	try {
-		const { readdirSync } = require("node:fs") as typeof import("node:fs");
-		for (const dirPath of walkDirs(sessionsDir)) {
-			for (const file of readdirSync(dirPath)) {
-				if (file.endsWith(`${sessionId}.jsonl`)) {
-					return join(dirPath, file);
-				}
-			}
-		}
-	} catch {
-		// walkSync may not be available on all Node versions; fall back to find
-	}
-	return findRolloutPathFallback(sessionId, sessionsDir);
-}
-
-function findRolloutPathFallback(
-	sessionId: string,
-	sessionsDir: string,
-): string {
 	const found = walkForSession(sessionsDir, sessionId);
-	return found ?? join(sessionsDir, "unknown", `${sessionId}.jsonl`);
+	if (found) return found;
+	return join(sessionsDir, "unknown", `${sessionId}.jsonl`);
 }
 
 /** Recursively walk all subdirectories, yielding each directory path. */
 function* walkDirs(dir: string): Generator<string> {
-	const { readdirSync, statSync } =
-		require("node:fs") as typeof import("node:fs");
-	for (const entry of readdirSync(dir)) {
-		const full = join(dir, entry);
-		const stat = statSync(full);
-		if (stat.isDirectory()) {
-			yield full;
-			yield* walkDirs(full);
+	try {
+		for (const entry of readdirSync(dir)) {
+			const full = join(dir, entry);
+			const stat = statSync(full);
+			if (stat.isDirectory()) {
+				yield full;
+				yield* walkDirs(full);
+			}
 		}
+	} catch {
+		// Directory may not exist or be readable
 	}
 }
 
 /** Find the rollout file for a given session ID by walking directories. */
 function walkForSession(sessionsDir: string, sessionId: string): string | null {
-	const { readdirSync } = require("node:fs") as typeof import("node:fs");
 	for (const dirPath of walkDirs(sessionsDir)) {
-		for (const file of readdirSync(dirPath)) {
-			if (file.startsWith("rollout-") && file.endsWith(`${sessionId}.jsonl`)) {
-				return join(dirPath, file);
+		try {
+			for (const file of readdirSync(dirPath)) {
+				if (file.startsWith("rollout-") && file.endsWith(`${sessionId}.jsonl`)) {
+					return join(dirPath, file);
+				}
 			}
+		} catch {
+			// Skip unreadable directories
 		}
 	}
 	return null;

package/packages/config-capture/package.json

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

package/packages/django-plugin/package.json

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

package/packages/e2e-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/e2e-tester",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/jev-judge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/jev-judge",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Jev Judge - Structured decision model for agent routing, E2E testing, and automated decisions",
   "type": "module",
   "main": "./dist/index.js",

package/packages/knowledge-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-graph",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "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.252",
+  "version": "1.1.255",
   "description": "Memory engine with OKF integration for durable knowledge management (RFC-0060)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/milestone-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/milestone-manager",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Track milestones and alerts when items are at risk",
   "type": "module",
   "main": "./dist/index.js",

package/packages/model-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/model-registry",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Model Registry for pi-harness-runtime — centralized model metadata with pricing",
   "type": "module",
   "main": "./dist/index.js",

package/packages/nextjs-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/nextjs-plugin",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Next.js framework detection and analysis for pi-harness-runtime (RFC-0062)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/notification/package.json

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

package/packages/observability/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/observability",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Comprehensive observability system with structured logging, tracing, metrics, and alerting",
   "type": "module",
   "main": "./dist/index.js",

package/packages/okf-indexer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/okf-indexer",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "OKF document indexer for SKILL.md files (RFC-0106)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/paperclip-integration/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/paperclip-integration",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Paperclip API integration: poll agent inbox, route tasks to pi.dev, Telegram alerts",
   "type": "module",
   "main": "./dist/index.js",

package/packages/performance-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/performance-optimizer",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Performance optimization analyzer for pi-harness runtime (RFC-0056)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/privilege-broker/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/privilege-broker",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Privilege Broker — capability registry and command executor for autonomous runtime (RFC-0101 §7)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/project-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/project-analyzer",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Project analysis system for pi-harness-runtime - detects frameworks, rules, and project structure",
   "type": "module",
   "main": "./dist/index.js",

package/packages/project-bootstrap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/project-bootstrap",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Project scaffolding from typed ProjectSpec",
   "type": "module",
   "main": "./dist/index.js",

package/packages/projection-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/projection-engine",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/prompt-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/prompt-compiler",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "Deterministic prompt compiler for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/prompt-versioning/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/prompt-versioning",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "type": "module",
   "description": "Version control for prompts with rollback support (RFC-0019)",
   "main": "dist/index.js",

package/packages/provider-adapter-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/provider-adapter-sdk",
-  "version": "1.1.252",
+  "version": "1.1.255",
   "description": "SDK for building, testing, and registering AI provider adapters",
   "type": "module",
   "main": "./dist/index.js",