pi-harness-runtime 1.1.366 → 1.1.368

package/AGENTS.md

@@ -490,3 +490,36 @@ bun run start      # ✅ Correct - run compiled
 bun run build && bun run test    # CI pipeline
 bun run build && bun run start   # Server deployment
 ```
+
+### 14. Workspace Environment Auto-Detection
+
+**At session start, the harness auto-detects:**
+- `.env` file presence → Dev environment
+- `package.json` `dev` script → Hot reload available
+- `NODE_ENV` value → development/production
+- System RAM → Low RAM warning (<16GB)
+
+**This info is stored in:**
+```
+~/.pi-harness-runtime/workspace-env.sqlite
+```
+
+**Agent should check workspace environment BEFORE running build commands:**
+
+```
+On Dev PC with hot reload:
+  → DON'T: bun run build (unless explicitly asked)
+  → DO: bun run dev (compiles on-demand, saves RAM)
+
+On CI/Production:
+  → DO: bun run build (always build first)
+```
+
+**Decision flow:**
+```
+Is this a dev workspace? (.env, dev script exists?)
+  └─ YES + Has dev script?
+       └─ YES → Use bun run dev (no build needed)
+       └─ NO  → May need build
+  └─ NO → Build required (production/server)
+```

package/index.ts

@@ -138,6 +138,8 @@ const sharedState = {
 	pqController: null as any,
 	// eslint-disable-next-line @typescript-eslint/no-explicit-any
 	delegationHarness: null as any,
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	workspaceEnvMessage: null as string | null,
 };
 
 async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
@@ -386,6 +388,16 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 			_piSessionCwd = realpathSync(process.cwd());
 			logToFile("[codex-trigger]", "Pi session cwd captured:", _piSessionCwd);
 
+			// --- Detect workspace environment ---
+			try {
+				const { formatEnvForAgent } = await import("./packages/contracts/dist/workspace-env.js");
+				const envMessage = formatEnvForAgent(_piSessionCwd);
+				logToFile("[WorkspaceEnv]", envMessage);
+				sharedState.workspaceEnvMessage = envMessage;
+			} catch (e) {
+				logToFile("[WorkspaceEnv]", "Detection failed:", String(e));
+			}
+
 			// --- Drain pending greeting when Pi becomes active ---
 			if (codexSessionState.pendingGreeting) {
 				const pg = codexSessionState.pendingGreeting;

package/package.json

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

package/packages/agent-policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/agent-policy",
-  "version": "1.1.366",
+  "version": "1.1.368",
   "description": "Agent policy runtime for pi-harness - enforces mandatory rule delivery and mutation gating",
   "type": "module",
   "main": "./dist/index.js",

package/packages/architecture-generator/package.json

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

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

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

package/packages/connection-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/connection-runtime",
-  "version": "1.1.366",
+  "version": "1.1.368",
   "type": "module",
   "description": "Connection management with jittered exponential backoff for pi-harness",
   "main": "./dist/index.js",

package/packages/context-compiler/package.json

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

package/packages/contracts/dist/workspace-env.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare function detectWorkspaceEnv(workspacePath: string): WorkspaceEnvResult;
+/**
+ * Load cached workspace environment
+ */
+export declare function loadWorkspaceEnv(workspacePath: string): WorkspaceEnvResult | null;
+/**
+ * Get or detect workspace environment
+ */
+export declare function getWorkspaceEnv(workspacePath: string): WorkspaceEnvResult;
+/**
+ * Check if agent should prefer dev mode (no build)
+ */
+export declare function shouldUseDevMode(workspacePath: string): {
+    preferDev: boolean;
+    reason: string;
+    ramGb: number | null;
+};
+/**
+ * Format workspace env as agent-readable message
+ */
+export declare function formatEnvForAgent(workspacePath: string): string;

package/packages/contracts/dist/workspace-env.js

@@ -0,0 +1,231 @@
+/**
+ * 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() {
+    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() {
+    ensureStoreDir();
+    return join(STORE_DIR, "workspace-env.sqlite");
+}
+/**
+ * Initialize workspace environment database
+ */
+function initDatabase() {
+    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() {
+    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 and store workspace environment
+ */
+export function detectWorkspaceEnv(workspacePath) {
+    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 = 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) {
+    const db = initDatabase();
+    const row = db.prepare("SELECT * FROM workspace_env WHERE workspace_path = ?").get(workspacePath);
+    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) {
+    // 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) {
+    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) {
+    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/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/contracts",
-  "version": "1.1.366",
+  "version": "1.1.368",
   "type": "module",
   "description": "RPC schema definitions for pi-harness runtime",
   "main": "./dist/index.js",