@oh-my-pi/pi-utils 16.3.11 → 16.3.12

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## [Unreleased]
 
+## [16.3.12] - 2026-07-08
+
+### Added
+
+- Added `postmortem.interceptUnhandledRejections()` to register interceptors consulted before an unhandled rejection tears the process down; a consuming interceptor (e.g. the JS eval runtime claiming rejections floated by user cell code) keeps the process alive and owns reporting.
+
+### Fixed
+
+- Fixed child shell environment filtering to drop launch-directory `.env.local` values that Bun auto-loaded before OMP starts command shells. ([#4723](https://github.com/can1357/oh-my-pi/issues/4723))
+
 ## [16.3.10] - 2026-07-06
 
 ### Added

package/dist/types/env.d.ts

@@ -17,6 +17,8 @@ export declare function isSafeEnvName(name: string): boolean;
 export declare function isSafeEnvValue(value: string): boolean;
 export declare function isMacosMallocStackLoggingEnvName(name: string): boolean;
 export declare function filterProcessEnv(env: Record<string, string | undefined>): Record<string, string>;
+/** Filters process env for child shells without launch-cwd `.env.local` values. */
+export declare function filterChildShellEnv(env: Record<string, string | undefined>, cwd?: string): Record<string, string>;
 /**
  * Parses a .env file synchronously and extracts key-value string pairs.
  * Ignores lines that are empty or start with '#'. Trims whitespace.

package/dist/types/postmortem.d.ts

@@ -31,6 +31,14 @@ export declare function markExpectedCleanupError<T extends object>(reason: T): T
  * its `cause`.
  */
 export declare function isExpectedCleanupError(reason: unknown): boolean;
+/**
+ * Register an interceptor consulted before an unhandled rejection tears the
+ * process down. Return `true` to consume the rejection — the interceptor owns
+ * reporting and the process continues. Used by embedded script runtimes (JS
+ * eval cells) whose user code can float rejections the host must not die for.
+ * Returns an unregister function.
+ */
+export declare function interceptUnhandledRejections(interceptor: (reason: unknown) => boolean): () => void;
 /**
  * Register a process cleanup callback, to be run on shutdown, signal, or fatal error.
  *

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-utils",
-	"version": "16.3.11",
+	"version": "16.3.12",
 	"description": "Shared utilities for pi packages",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -31,7 +31,7 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "16.3.11",
+		"@oh-my-pi/pi-natives": "16.3.12",
 		"handlebars": "^4.7.9",
 		"winston": "^3.19.0",
 		"winston-daily-rotate-file": "^5.0.0"

package/src/env.ts

@@ -53,6 +53,19 @@ export function filterProcessEnv(env: Record<string, string | undefined>): Recor
 	return result;
 }
 
+/** Filters process env for child shells without launch-cwd `.env.local` values. */
+export function filterChildShellEnv(
+	env: Record<string, string | undefined>,
+	cwd: string = process.cwd(),
+): Record<string, string> {
+	const result = filterProcessEnv(env);
+	const launchLocalEnv = parseEnvFile(path.join(cwd, ".env.local"));
+	for (const key in launchLocalEnv) {
+		if (result[key] === launchLocalEnv[key]) delete result[key];
+	}
+	return result;
+}
+
 /**
  * Parses a .env file synchronously and extracts key-value string pairs.
  * Ignores lines that are empty or start with '#'. Trims whitespace.

package/src/postmortem.ts

@@ -121,6 +121,24 @@ export function isExpectedCleanupError(reason: unknown): boolean {
 	return false;
 }
 
+/**
+ * Interceptors consulted by the global `unhandledRejection` handler before the
+ * fatal path. See {@link interceptUnhandledRejections}.
+ */
+const rejectionInterceptors = new Set<(reason: unknown) => boolean>();
+
+/**
+ * Register an interceptor consulted before an unhandled rejection tears the
+ * process down. Return `true` to consume the rejection — the interceptor owns
+ * reporting and the process continues. Used by embedded script runtimes (JS
+ * eval cells) whose user code can float rejections the host must not die for.
+ * Returns an unregister function.
+ */
+export function interceptUnhandledRejections(interceptor: (reason: unknown) => boolean): () => void {
+	rejectionInterceptors.add(interceptor);
+	return () => rejectionInterceptors.delete(interceptor);
+}
+
 function formatFatalError(label: string, err: Error): string {
 	const name = err.name || "Error";
 	const message = err.message || "(no message)";
@@ -172,6 +190,15 @@ if (isMainThread) {
 				logger.warn("Ignoring expected cleanup rejection", { err });
 				return;
 			}
+			for (const interceptor of rejectionInterceptors) {
+				try {
+					if (interceptor(reason)) return;
+				} catch (interceptorErr) {
+					logger.warn("Unhandled-rejection interceptor threw; continuing with fatal path", {
+						err: interceptorErr,
+					});
+				}
+			}
 			process.stderr.write(formatFatalError("Unhandled Rejection", err));
 			logger.error("Unhandled rejection", { err });
 			await runCleanup(Reason.UNHANDLED_REJECTION);

package/src/procmgr.ts

@@ -2,7 +2,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { Process, ProcessStatus } from "@oh-my-pi/pi-natives";
 import type { Subprocess } from "bun";
-import { $env, filterProcessEnv } from "./env";
+import { $env, filterChildShellEnv } from "./env";
 import { $which } from "./which";
 
 export interface ShellConfig {
@@ -31,7 +31,7 @@ export function isExecutable(path: string): boolean {
 function buildSpawnEnv(shell: string): Record<string, string> {
 	const noCI = $env.PI_BASH_NO_CI || $env.CLAUDE_BASH_NO_CI;
 	return {
-		...filterProcessEnv(Bun.env),
+		...filterChildShellEnv(Bun.env),
 		SHELL: shell,
 		GIT_EDITOR: "true",
 		GPG_TTY: "not a tty",