pi-harness-runtime 1.1.366 → 1.1.368

package/packages/contracts/src/workspace-env.ts

@@ -0,0 +1,278 @@
+/**
+ * Workspace Environment Detector
+ *
+ * Detects if the workspace is a development environment by checking:
+ * 1. .env file existence and NODE_ENV value
+ * 2. package.json "dev" script presence
+ * 3. .env.development or .env.local files
+ *
+ * Stores detected environment in SQLite for agent reference.
+ */
+
+import { DatabaseSync } from "node:sqlite";
+import { existsSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const STORE_DIR = join(process.env.HOME || "/home/frappe", ".pi-harness-runtime");
+
+/**
+ * Ensure store directory exists
+ */
+function ensureStoreDir(): void {
+	if (!existsSync(STORE_DIR)) {
+		// mkdirSync is not available in all contexts, use fs promises or exec
+		import("fs").then((fs) => fs.mkdirSync(STORE_DIR, { recursive: true }));
+	}
+}
+
+/**
+ * Get workspace database path
+ */
+function getDbPath(): string {
+	ensureStoreDir();
+	return join(STORE_DIR, "workspace-env.sqlite");
+}
+
+/**
+ * Initialize workspace environment database
+ */
+function initDatabase(): DatabaseSync {
+	const db = new DatabaseSync(getDbPath());
+	db.exec(`
+		CREATE TABLE IF NOT EXISTS workspace_env (
+			workspace_path TEXT PRIMARY KEY,
+			is_dev_env INTEGER NOT NULL DEFAULT 0,
+			has_dev_script INTEGER NOT NULL DEFAULT 0,
+			node_env TEXT,
+			has_env_file INTEGER NOT NULL DEFAULT 0,
+			ram_gb REAL,
+			detected_at INTEGER NOT NULL,
+			updated_at INTEGER NOT NULL
+		)
+	`);
+	return db;
+}
+
+/**
+ * Detect RAM in GB
+ */
+function detectRamGb(): number | null {
+	try {
+		if (process.platform === "linux") {
+			const meminfo = readFileSync("/proc/meminfo", "utf8");
+			const match = meminfo.match(/MemTotal:\\s+(\\d+)\\s+kB/);
+			if (match) {
+				return Math.round((parseInt(match[1], 10) / 1024 / 1024) * 10) / 10;
+			}
+		} else if (process.platform === "darwin") {
+			const out = require("child_process").execSync("sysctl hw.memsize", { encoding: "utf8" });
+			const match = out.match(/hw\\.memsize:\\s+(\\d+)/);
+			if (match) {
+				return Math.round((parseInt(match[1], 10) / 1024 / 1024 / 1024) * 10) / 10;
+			}
+		}
+	} catch {
+		// Fallback: return null
+	}
+	return null;
+}
+
+/**
+ * Detect if workspace is a dev environment
+ */
+export interface WorkspaceEnvResult {
+	workspacePath: string;
+	isDevEnv: boolean;
+	hasDevScript: boolean;
+	nodeEnv: string | null;
+	hasEnvFile: boolean;
+	ramGb: number | null;
+	detectedAt: number;
+}
+
+/**
+ * Detect and store workspace environment
+ */
+export function detectWorkspaceEnv(workspacePath: string): WorkspaceEnvResult {
+	const now = Date.now();
+	const ramGb = detectRamGb();
+
+	// Check for .env files
+	const hasEnvFile = existsSync(join(workspacePath, ".env")) ||
+		existsSync(join(workspacePath, ".env.development")) ||
+		existsSync(join(workspacePath, ".env.local")) ||
+		existsSync(join(workspacePath, ".env.dev"));
+
+	// Read NODE_ENV from .env file if present
+	let nodeEnv: string | null = null;
+	const envFile = join(workspacePath, ".env");
+	if (existsSync(envFile)) {
+		try {
+			const envContent = readFileSync(envFile, "utf8");
+			const match = envContent.match(/NODE_ENV=(.+)/);
+			if (match) {
+				nodeEnv = match[1].trim().replace(/['"]/g, "");
+			}
+		} catch {
+			// Ignore read errors
+		}
+	}
+
+	// Check for dev script in package.json
+	let hasDevScript = false;
+	const pkgJsonPath = join(workspacePath, "package.json");
+	if (existsSync(pkgJsonPath)) {
+		try {
+			const pkg = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+			hasDevScript = !!(pkg.scripts && (pkg.scripts.dev || pkg.scripts.development));
+		} catch {
+			// Ignore parse errors
+		}
+	}
+
+	// Determine if this is a dev environment
+	// Dev env if: has .env file OR has dev script OR NODE_ENV=development
+	const isDevEnv = hasEnvFile || hasDevScript || nodeEnv === "development" || nodeEnv === "dev";
+
+	// Store in SQLite
+	const db = initDatabase();
+	db.prepare(`
+		INSERT OR REPLACE INTO workspace_env 
+		(workspace_path, is_dev_env, has_dev_script, node_env, has_env_file, ram_gb, detected_at, updated_at)
+		VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+	`).run(workspacePath, isDevEnv ? 1 : 0, hasDevScript ? 1 : 0, nodeEnv, hasEnvFile ? 1 : 0, ramGb, now, now);
+
+	db.close();
+
+	return {
+		workspacePath,
+		isDevEnv,
+		hasDevScript,
+		nodeEnv,
+		hasEnvFile,
+		ramGb,
+		detectedAt: now,
+	};
+}
+
+/**
+ * Load cached workspace environment
+ */
+export function loadWorkspaceEnv(workspacePath: string): WorkspaceEnvResult | null {
+	const db = initDatabase();
+	const row = db.prepare("SELECT * FROM workspace_env WHERE workspace_path = ?").get(workspacePath) as {
+		workspace_path: string;
+		is_dev_env: number;
+		has_dev_script: number;
+		node_env: string | null;
+		has_env_file: number;
+		ram_gb: number | null;
+		detected_at: number;
+	} | undefined;
+	db.close();
+
+	if (!row) return null;
+
+	return {
+		workspacePath: row.workspace_path,
+		isDevEnv: row.is_dev_env === 1,
+		hasDevScript: row.has_dev_script === 1,
+		nodeEnv: row.node_env,
+		hasEnvFile: row.has_env_file === 1,
+		ramGb: row.ram_gb,
+		detectedAt: row.detected_at,
+	};
+}
+
+/**
+ * Get or detect workspace environment
+ */
+export function getWorkspaceEnv(workspacePath: string): WorkspaceEnvResult {
+	// Try to load cached result first
+	const cached = loadWorkspaceEnv(workspacePath);
+	if (cached) {
+		// Check if cache is recent (within 1 hour)
+		const ageMs = Date.now() - cached.detectedAt;
+		if (ageMs < 60 * 60 * 1000) {
+			return cached;
+		}
+	}
+	// Detect fresh
+	return detectWorkspaceEnv(workspacePath);
+}
+
+/**
+ * Check if agent should prefer dev mode (no build)
+ */
+export function shouldUseDevMode(workspacePath: string): {
+	preferDev: boolean;
+	reason: string;
+	ramGb: number | null;
+} {
+	const env = getWorkspaceEnv(workspacePath);
+
+	// Low RAM threshold
+	const LOW_RAM_GB = 16;
+
+	if (!env.isDevEnv) {
+		return {
+			preferDev: false,
+			reason: "Not detected as dev environment",
+			ramGb: env.ramGb,
+		};
+	}
+
+	if (env.ramGb !== null && env.ramGb < LOW_RAM_GB) {
+		return {
+			preferDev: true,
+			reason: `Low RAM (${env.ramGb}GB < ${LOW_RAM_GB}GB) - avoid parallel build + dev`,
+			ramGb: env.ramGb,
+		};
+	}
+
+	if (env.hasDevScript) {
+		return {
+			preferDev: true,
+			reason: `Dev script detected - hot reload available`,
+			ramGb: env.ramGb,
+		};
+	}
+
+	return {
+		preferDev: false,
+		reason: "Dev environment but no dev script found",
+		ramGb: env.ramGb,
+	};
+}
+
+/**
+ * Format workspace env as agent-readable message
+ */
+export function formatEnvForAgent(workspacePath: string): string {
+	const env = shouldUseDevMode(workspacePath);
+	const details = getWorkspaceEnv(workspacePath);
+
+	let message = `[Workspace Environment]\n`;
+	message += `- Path: ${workspacePath}\n`;
+	message += `- Detected: ${details.isDevEnv ? "Development" : "Production/Unknown"}\n`;
+	message += `- Has dev script: ${details.hasDevScript ? "Yes" : "No"}\n`;
+	message += `- NODE_ENV: ${details.nodeEnv || "not set"}\n`;
+	message += `- Has .env file: ${details.hasEnvFile ? "Yes" : "No"}\n`;
+	message += `- RAM: ${details.ramGb ? `${details.ramGb}GB` : "unknown"}\n`;
+	message += `\n`;
+
+	if (env.preferDev) {
+		message += `RECOMMENDATION: Use \`dev\` mode (no build needed)\n`;
+		message += `Reason: ${env.reason}\n`;
+		message += `→ Run: \`bun run dev\` (or \`npm run dev\`)\n`;
+		message += `→ DON'T: Run \`build\` unless explicitly requested\n`;
+	} else {
+		message += `RECOMMENDATION: Build may be needed\n`;
+		message += `Reason: ${env.reason}\n`;
+		message += `→ Use: \`bun run build\` before running\n`;
+	}
+
+	return message;
+}

package/packages/cookie-sanitizer/package.json

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

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "1.1.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "description": "Performance optimization analyzer for pi-harness runtime (RFC-0056)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/permission-mode/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/permission-mode",
-  "version": "1.1.366",
+  "version": "1.1.368",
   "type": "module",
   "description": "Runtime permission modes for pi-harness - Supervised/Auto/Full-access",
   "main": "./dist/index.js",

package/packages/privilege-broker/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/privilege-broker",
-  "version": "1.1.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "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.366",
+  "version": "1.1.368",
   "type": "module",
   "main": "src/index.ts",
   "exports": {