lifecycleion 0.0.7 → 0.0.9

package/README.md

@@ -1,4 +1,4 @@
-# Lifecycleion v0.0.7
+# Lifecycleion v0.0.9
 
 [![npm version](https://badge.fury.io/js/lifecycleion.svg)](https://badge.fury.io/js/lifecycleion)
 
@@ -89,6 +89,7 @@ Each library has comprehensive documentation in the [docs](./docs) folder. Click
 | [constants](./docs/constants.md)                                   | `lifecycleion/constants`                  | Common string constants including whitespace helpers and Python-style character sets                                                     |
 | [curly-brackets](./docs/curly-brackets.md)                         | `lifecycleion/curly-brackets`             | String templating with `{{placeholders}}`, fallbacks, escaping, and compiled templates                                                   |
 | [deep-clone](./docs/deep-clone.md)                                 | `lifecycleion/deep-clone`                 | Deep clone utility with circular reference detection for objects, arrays, Maps, Sets, and more                                           |
+| [dev-mode](./docs/dev-mode.md)                                     | `lifecycleion/dev-mode`                   | Runtime-settable dev/production mode flag with auto-detection from CLI args or NODE_ENV                                                  |
 | [error-to-string](./docs/error-to-string.md)                       | `lifecycleion/error-to-string`            | Format errors into readable ASCII tables with support for nested info and sensitive field masking                                        |
 | [event-emitter](./docs/event-emitter.md)                           | `lifecycleion/event-emitter`              | Lightweight event emitter with protected and public variants, type safety, and memory management                                         |
 | [id-helpers](./docs/id-helpers.md)                                 | `lifecycleion/id-helpers`                 | Unified ID generation and validation for ObjectID, UUID v4, UUID v7, and ULID                                                            |

package/dist/lib/dev-mode.cjs

@@ -0,0 +1,77 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/dev-mode.ts
+var dev_mode_exports = {};
+__export(dev_mode_exports, {
+  getDevMode: () => getDevMode,
+  initDevMode: () => initDevMode,
+  overrideDevMode: () => overrideDevMode
+});
+module.exports = __toCommonJS(dev_mode_exports);
+var GLOBAL_KEY = "__lifecycleion_is_dev__";
+var INIT_PARAM_KEY = "__lifecycleion_init_param__";
+var g = globalThis;
+function detectValue(detect, isStrict) {
+  const argv = typeof process !== "undefined" ? process.argv ?? [] : [];
+  const env = typeof process !== "undefined" ? process.env?.NODE_ENV : void 0;
+  const cmdArg = argv.find((a) => a === "dev" || a === "prod");
+  if (isStrict && detect === "cmd" && cmdArg === void 0) {
+    throw new Error('initDevMode: expected "dev" or "prod" as a CLI argument');
+  }
+  const isFromCmd = cmdArg !== void 0 ? cmdArg === "dev" : false;
+  const isFromEnv = env === "development";
+  if (detect === "cmd") {
+    return isFromCmd;
+  }
+  if (detect === "node_env") {
+    return isFromEnv;
+  }
+  return cmdArg !== void 0 ? isFromCmd : isFromEnv;
+}
+function resolveInitParam(param) {
+  if (param === void 0) {
+    return detectValue("both");
+  }
+  if (typeof param === "boolean") {
+    return param;
+  }
+  return detectValue(param.detect, param.strict);
+}
+function getDevMode() {
+  return typeof g[GLOBAL_KEY] === "boolean" ? g[GLOBAL_KEY] : false;
+}
+function initDevMode(param) {
+  if (typeof g[GLOBAL_KEY] === "boolean") {
+    return;
+  }
+  g[INIT_PARAM_KEY] = param;
+  g[GLOBAL_KEY] = resolveInitParam(param);
+}
+function overrideDevMode(value) {
+  const savedParam = g[INIT_PARAM_KEY];
+  g[GLOBAL_KEY] = value === "redetect" ? resolveInitParam(savedParam) : value;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDevMode,
+  initDevMode,
+  overrideDevMode
+});
+//# sourceMappingURL=dev-mode.cjs.map

package/dist/lib/dev-mode.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/dev-mode.ts"],"sourcesContent":["// Stored in globalThis so state survives module re-evaluation and works across\n// module boundaries.\nconst GLOBAL_KEY = '__lifecycleion_is_dev__';\nconst INIT_PARAM_KEY = '__lifecycleion_init_param__';\n\ntype DevModeSource = 'cmd' | 'node_env' | 'both';\ntype InitParam =\n  | boolean\n  | { detect: DevModeSource; strict?: boolean }\n  | undefined;\n\n// Cast once at module level — avoids repeating the assertion in every function.\nconst g = globalThis as typeof globalThis & Record<string, unknown>;\n\nfunction detectValue(detect: DevModeSource, isStrict?: boolean): boolean {\n  // Guard against environments where process or its properties may not exist\n  // (e.g. browser without polyfill, Deno without Node compat, edge runtimes).\n  // Vite statically replaces process.env.NODE_ENV at build time, so it is safe\n  // on the client. process.argv is an empty array shim in browsers — harmless.\n  const argv: string[] =\n    typeof process !== 'undefined' ? (process.argv ?? []) : [];\n  const env: string | undefined =\n    typeof process !== 'undefined' ? process.env?.NODE_ENV : undefined;\n\n  const cmdArg = argv.find((a) => a === 'dev' || a === 'prod');\n\n  if (isStrict && detect === 'cmd' && cmdArg === undefined) {\n    throw new Error('initDevMode: expected \"dev\" or \"prod\" as a CLI argument');\n  }\n\n  const isFromCmd = cmdArg !== undefined ? cmdArg === 'dev' : false;\n  const isFromEnv = env === 'development';\n\n  if (detect === 'cmd') {\n    return isFromCmd;\n  }\n\n  if (detect === 'node_env') {\n    return isFromEnv;\n  }\n\n  // 'both': cmd wins when explicitly present, otherwise fall back to NODE_ENV\n  return cmdArg !== undefined ? isFromCmd : isFromEnv;\n}\n\nfunction resolveInitParam(param: InitParam): boolean {\n  if (param === undefined) {\n    return detectValue('both');\n  }\n\n  if (typeof param === 'boolean') {\n    return param;\n  }\n\n  return detectValue(param.detect, param.strict);\n}\n\n/**\n * Returns the current dev mode value.\n *\n * Reads `globalThis.__lifecycleion_is_dev__`. Defaults to `false` if\n * `initDevMode()` has not been called yet.\n */\nexport function getDevMode(): boolean {\n  return typeof g[GLOBAL_KEY] === 'boolean' ? g[GLOBAL_KEY] : false;\n}\n\n/**\n * Sets the dev mode global for the current process.\n *\n * First-wins: if the global is already set (e.g. set by the HTML injection on\n * the client, or by a prior `initDevMode()` call), this is a no-op. Call once\n * at startup before serving any requests.\n *\n * @param param\n *   - `true` / `false` — explicit value\n *   - `{ detect: 'cmd' }` — read from `process.argv` (\"dev\" or \"prod\")\n *   - `{ detect: 'node_env' }` — read from `NODE_ENV`\n *   - `{ detect: 'both' }` — argv takes precedence, falls back to `NODE_ENV`\n *   - `{ detect: 'cmd', strict: true }` — argv required, throws if absent\n *   - omitted — same as `{ detect: 'both' }`\n */\nexport function initDevMode(\n  param?: boolean | { detect: DevModeSource; strict?: boolean },\n): void {\n  if (typeof g[GLOBAL_KEY] === 'boolean') {\n    return; // first-wins — already initialized, no-op\n  }\n\n  g[INIT_PARAM_KEY] = param; // save original param so 'redetect' can replay it\n  g[GLOBAL_KEY] = resolveInitParam(param);\n}\n\n/**\n * Bypasses first-wins semantics and forces the dev mode value.\n *\n * Intended for testing or tooling — not for production use.\n *\n * Pass `'redetect'` to re-run the same detection logic that\n * `initDevMode()` used originally.\n */\nexport function overrideDevMode(value: boolean | 'redetect'): void {\n  const savedParam = g[INIT_PARAM_KEY] as InitParam;\n  g[GLOBAL_KEY] = value === 'redetect' ? resolveInitParam(savedParam) : value;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAM,aAAa;AACnB,IAAM,iBAAiB;AASvB,IAAM,IAAI;AAEV,SAAS,YAAY,QAAuB,UAA6B;AAKvE,QAAM,OACJ,OAAO,YAAY,cAAe,QAAQ,QAAQ,CAAC,IAAK,CAAC;AAC3D,QAAM,MACJ,OAAO,YAAY,cAAc,QAAQ,KAAK,WAAW;AAE3D,QAAM,SAAS,KAAK,KAAK,CAAC,MAAM,MAAM,SAAS,MAAM,MAAM;AAE3D,MAAI,YAAY,WAAW,SAAS,WAAW,QAAW;AACxD,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC3E;AAEA,QAAM,YAAY,WAAW,SAAY,WAAW,QAAQ;AAC5D,QAAM,YAAY,QAAQ;AAE1B,MAAI,WAAW,OAAO;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,WAAW,YAAY;AACzB,WAAO;AAAA,EACT;AAGA,SAAO,WAAW,SAAY,YAAY;AAC5C;AAEA,SAAS,iBAAiB,OAA2B;AACnD,MAAI,UAAU,QAAW;AACvB,WAAO,YAAY,MAAM;AAAA,EAC3B;AAEA,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO;AAAA,EACT;AAEA,SAAO,YAAY,MAAM,QAAQ,MAAM,MAAM;AAC/C;AAQO,SAAS,aAAsB;AACpC,SAAO,OAAO,EAAE,UAAU,MAAM,YAAY,EAAE,UAAU,IAAI;AAC9D;AAiBO,SAAS,YACd,OACM;AACN,MAAI,OAAO,EAAE,UAAU,MAAM,WAAW;AACtC;AAAA,EACF;AAEA,IAAE,cAAc,IAAI;AACpB,IAAE,UAAU,IAAI,iBAAiB,KAAK;AACxC;AAUO,SAAS,gBAAgB,OAAmC;AACjE,QAAM,aAAa,EAAE,cAAc;AACnC,IAAE,UAAU,IAAI,UAAU,aAAa,iBAAiB,UAAU,IAAI;AACxE;","names":[]}

package/dist/lib/dev-mode.d.cts

@@ -0,0 +1,38 @@
+type DevModeSource = 'cmd' | 'node_env' | 'both';
+/**
+ * Returns the current dev mode value.
+ *
+ * Reads `globalThis.__lifecycleion_is_dev__`. Defaults to `false` if
+ * `initDevMode()` has not been called yet.
+ */
+declare function getDevMode(): boolean;
+/**
+ * Sets the dev mode global for the current process.
+ *
+ * First-wins: if the global is already set (e.g. set by the HTML injection on
+ * the client, or by a prior `initDevMode()` call), this is a no-op. Call once
+ * at startup before serving any requests.
+ *
+ * @param param
+ *   - `true` / `false` — explicit value
+ *   - `{ detect: 'cmd' }` — read from `process.argv` ("dev" or "prod")
+ *   - `{ detect: 'node_env' }` — read from `NODE_ENV`
+ *   - `{ detect: 'both' }` — argv takes precedence, falls back to `NODE_ENV`
+ *   - `{ detect: 'cmd', strict: true }` — argv required, throws if absent
+ *   - omitted — same as `{ detect: 'both' }`
+ */
+declare function initDevMode(param?: boolean | {
+    detect: DevModeSource;
+    strict?: boolean;
+}): void;
+/**
+ * Bypasses first-wins semantics and forces the dev mode value.
+ *
+ * Intended for testing or tooling — not for production use.
+ *
+ * Pass `'redetect'` to re-run the same detection logic that
+ * `initDevMode()` used originally.
+ */
+declare function overrideDevMode(value: boolean | 'redetect'): void;
+
+export { getDevMode, initDevMode, overrideDevMode };

package/dist/lib/dev-mode.d.ts

@@ -0,0 +1,38 @@
+type DevModeSource = 'cmd' | 'node_env' | 'both';
+/**
+ * Returns the current dev mode value.
+ *
+ * Reads `globalThis.__lifecycleion_is_dev__`. Defaults to `false` if
+ * `initDevMode()` has not been called yet.
+ */
+declare function getDevMode(): boolean;
+/**
+ * Sets the dev mode global for the current process.
+ *
+ * First-wins: if the global is already set (e.g. set by the HTML injection on
+ * the client, or by a prior `initDevMode()` call), this is a no-op. Call once
+ * at startup before serving any requests.
+ *
+ * @param param
+ *   - `true` / `false` — explicit value
+ *   - `{ detect: 'cmd' }` — read from `process.argv` ("dev" or "prod")
+ *   - `{ detect: 'node_env' }` — read from `NODE_ENV`
+ *   - `{ detect: 'both' }` — argv takes precedence, falls back to `NODE_ENV`
+ *   - `{ detect: 'cmd', strict: true }` — argv required, throws if absent
+ *   - omitted — same as `{ detect: 'both' }`
+ */
+declare function initDevMode(param?: boolean | {
+    detect: DevModeSource;
+    strict?: boolean;
+}): void;
+/**
+ * Bypasses first-wins semantics and forces the dev mode value.
+ *
+ * Intended for testing or tooling — not for production use.
+ *
+ * Pass `'redetect'` to re-run the same detection logic that
+ * `initDevMode()` used originally.
+ */
+declare function overrideDevMode(value: boolean | 'redetect'): void;
+
+export { getDevMode, initDevMode, overrideDevMode };

package/dist/lib/dev-mode.js

@@ -0,0 +1,50 @@
+// src/lib/dev-mode.ts
+var GLOBAL_KEY = "__lifecycleion_is_dev__";
+var INIT_PARAM_KEY = "__lifecycleion_init_param__";
+var g = globalThis;
+function detectValue(detect, isStrict) {
+  const argv = typeof process !== "undefined" ? process.argv ?? [] : [];
+  const env = typeof process !== "undefined" ? process.env?.NODE_ENV : void 0;
+  const cmdArg = argv.find((a) => a === "dev" || a === "prod");
+  if (isStrict && detect === "cmd" && cmdArg === void 0) {
+    throw new Error('initDevMode: expected "dev" or "prod" as a CLI argument');
+  }
+  const isFromCmd = cmdArg !== void 0 ? cmdArg === "dev" : false;
+  const isFromEnv = env === "development";
+  if (detect === "cmd") {
+    return isFromCmd;
+  }
+  if (detect === "node_env") {
+    return isFromEnv;
+  }
+  return cmdArg !== void 0 ? isFromCmd : isFromEnv;
+}
+function resolveInitParam(param) {
+  if (param === void 0) {
+    return detectValue("both");
+  }
+  if (typeof param === "boolean") {
+    return param;
+  }
+  return detectValue(param.detect, param.strict);
+}
+function getDevMode() {
+  return typeof g[GLOBAL_KEY] === "boolean" ? g[GLOBAL_KEY] : false;
+}
+function initDevMode(param) {
+  if (typeof g[GLOBAL_KEY] === "boolean") {
+    return;
+  }
+  g[INIT_PARAM_KEY] = param;
+  g[GLOBAL_KEY] = resolveInitParam(param);
+}
+function overrideDevMode(value) {
+  const savedParam = g[INIT_PARAM_KEY];
+  g[GLOBAL_KEY] = value === "redetect" ? resolveInitParam(savedParam) : value;
+}
+export {
+  getDevMode,
+  initDevMode,
+  overrideDevMode
+};
+//# sourceMappingURL=dev-mode.js.map

package/dist/lib/dev-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/dev-mode.ts"],"sourcesContent":["// Stored in globalThis so state survives module re-evaluation and works across\n// module boundaries.\nconst GLOBAL_KEY = '__lifecycleion_is_dev__';\nconst INIT_PARAM_KEY = '__lifecycleion_init_param__';\n\ntype DevModeSource = 'cmd' | 'node_env' | 'both';\ntype InitParam =\n  | boolean\n  | { detect: DevModeSource; strict?: boolean }\n  | undefined;\n\n// Cast once at module level — avoids repeating the assertion in every function.\nconst g = globalThis as typeof globalThis & Record<string, unknown>;\n\nfunction detectValue(detect: DevModeSource, isStrict?: boolean): boolean {\n  // Guard against environments where process or its properties may not exist\n  // (e.g. browser without polyfill, Deno without Node compat, edge runtimes).\n  // Vite statically replaces process.env.NODE_ENV at build time, so it is safe\n  // on the client. process.argv is an empty array shim in browsers — harmless.\n  const argv: string[] =\n    typeof process !== 'undefined' ? (process.argv ?? []) : [];\n  const env: string | undefined =\n    typeof process !== 'undefined' ? process.env?.NODE_ENV : undefined;\n\n  const cmdArg = argv.find((a) => a === 'dev' || a === 'prod');\n\n  if (isStrict && detect === 'cmd' && cmdArg === undefined) {\n    throw new Error('initDevMode: expected \"dev\" or \"prod\" as a CLI argument');\n  }\n\n  const isFromCmd = cmdArg !== undefined ? cmdArg === 'dev' : false;\n  const isFromEnv = env === 'development';\n\n  if (detect === 'cmd') {\n    return isFromCmd;\n  }\n\n  if (detect === 'node_env') {\n    return isFromEnv;\n  }\n\n  // 'both': cmd wins when explicitly present, otherwise fall back to NODE_ENV\n  return cmdArg !== undefined ? isFromCmd : isFromEnv;\n}\n\nfunction resolveInitParam(param: InitParam): boolean {\n  if (param === undefined) {\n    return detectValue('both');\n  }\n\n  if (typeof param === 'boolean') {\n    return param;\n  }\n\n  return detectValue(param.detect, param.strict);\n}\n\n/**\n * Returns the current dev mode value.\n *\n * Reads `globalThis.__lifecycleion_is_dev__`. Defaults to `false` if\n * `initDevMode()` has not been called yet.\n */\nexport function getDevMode(): boolean {\n  return typeof g[GLOBAL_KEY] === 'boolean' ? g[GLOBAL_KEY] : false;\n}\n\n/**\n * Sets the dev mode global for the current process.\n *\n * First-wins: if the global is already set (e.g. set by the HTML injection on\n * the client, or by a prior `initDevMode()` call), this is a no-op. Call once\n * at startup before serving any requests.\n *\n * @param param\n *   - `true` / `false` — explicit value\n *   - `{ detect: 'cmd' }` — read from `process.argv` (\"dev\" or \"prod\")\n *   - `{ detect: 'node_env' }` — read from `NODE_ENV`\n *   - `{ detect: 'both' }` — argv takes precedence, falls back to `NODE_ENV`\n *   - `{ detect: 'cmd', strict: true }` — argv required, throws if absent\n *   - omitted — same as `{ detect: 'both' }`\n */\nexport function initDevMode(\n  param?: boolean | { detect: DevModeSource; strict?: boolean },\n): void {\n  if (typeof g[GLOBAL_KEY] === 'boolean') {\n    return; // first-wins — already initialized, no-op\n  }\n\n  g[INIT_PARAM_KEY] = param; // save original param so 'redetect' can replay it\n  g[GLOBAL_KEY] = resolveInitParam(param);\n}\n\n/**\n * Bypasses first-wins semantics and forces the dev mode value.\n *\n * Intended for testing or tooling — not for production use.\n *\n * Pass `'redetect'` to re-run the same detection logic that\n * `initDevMode()` used originally.\n */\nexport function overrideDevMode(value: boolean | 'redetect'): void {\n  const savedParam = g[INIT_PARAM_KEY] as InitParam;\n  g[GLOBAL_KEY] = value === 'redetect' ? resolveInitParam(savedParam) : value;\n}\n"],"mappings":";AAEA,IAAM,aAAa;AACnB,IAAM,iBAAiB;AASvB,IAAM,IAAI;AAEV,SAAS,YAAY,QAAuB,UAA6B;AAKvE,QAAM,OACJ,OAAO,YAAY,cAAe,QAAQ,QAAQ,CAAC,IAAK,CAAC;AAC3D,QAAM,MACJ,OAAO,YAAY,cAAc,QAAQ,KAAK,WAAW;AAE3D,QAAM,SAAS,KAAK,KAAK,CAAC,MAAM,MAAM,SAAS,MAAM,MAAM;AAE3D,MAAI,YAAY,WAAW,SAAS,WAAW,QAAW;AACxD,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC3E;AAEA,QAAM,YAAY,WAAW,SAAY,WAAW,QAAQ;AAC5D,QAAM,YAAY,QAAQ;AAE1B,MAAI,WAAW,OAAO;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,WAAW,YAAY;AACzB,WAAO;AAAA,EACT;AAGA,SAAO,WAAW,SAAY,YAAY;AAC5C;AAEA,SAAS,iBAAiB,OAA2B;AACnD,MAAI,UAAU,QAAW;AACvB,WAAO,YAAY,MAAM;AAAA,EAC3B;AAEA,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO;AAAA,EACT;AAEA,SAAO,YAAY,MAAM,QAAQ,MAAM,MAAM;AAC/C;AAQO,SAAS,aAAsB;AACpC,SAAO,OAAO,EAAE,UAAU,MAAM,YAAY,EAAE,UAAU,IAAI;AAC9D;AAiBO,SAAS,YACd,OACM;AACN,MAAI,OAAO,EAAE,UAAU,MAAM,WAAW;AACtC;AAAA,EACF;AAEA,IAAE,cAAc,IAAI;AACpB,IAAE,UAAU,IAAI,iBAAiB,KAAK;AACxC;AAUO,SAAS,gBAAgB,OAAmC;AACjE,QAAM,aAAa,EAAE,cAAc;AACnC,IAAE,UAAU,IAAI,UAAU,aAAa,iBAAiB,UAAU,IAAI;AACxE;","names":[]}

package/dist/lib/lifecycle-manager/index.cjs

@@ -2397,9 +2397,9 @@ var LifecycleManager = class extends EventEmitterProtected {
         startupOrder: this.getStartupOrderInternal()
       };
     } catch (error) {
-      const err = error;
+      const err = error instanceof Error ? error : new Error(String(error));
       const code = err instanceof DependencyCycleError ? "dependency_cycle" : "unknown_error";
-      this.logger.error("Failed to resolve startup order", {
+      this.logger.error("Failed to resolve startup order: {{error.message}}", {
         params: { error: err }
       });
       return {
@@ -2607,11 +2607,14 @@ var LifecycleManager = class extends EventEmitterProtected {
       try {
         startupOrder = this.getStartupOrderInternal();
       } catch (error) {
-        const err = error;
+        const err = error instanceof Error ? error : new Error(String(error));
         const code = err instanceof DependencyCycleError ? "dependency_cycle" : "unknown_error";
-        this.logger.error("Failed to resolve startup order", {
-          params: { error: err }
-        });
+        this.logger.error(
+          "Failed to resolve startup order: {{error.message}}",
+          {
+            params: { error: err }
+          }
+        );
         return {
           success: false,
           startedComponents: [],
@@ -2714,9 +2717,14 @@ var LifecycleManager = class extends EventEmitterProtected {
           };
         } else {
           if (component.isOptional()) {
-            this.logger.entity(name).warn("Optional component failed to start, continuing", {
-              params: { error: result.error }
-            });
+            this.logger.entity(name).warn(
+              "Optional component failed to start, continuing: {{error.message}}",
+              {
+                params: {
+                  error: result.error || new Error(result.reason || "Unknown error")
+                }
+              }
+            );
             this.lifecycleEvents.componentStartFailedOptional(
               name,
               result.error
@@ -2730,9 +2738,14 @@ var LifecycleManager = class extends EventEmitterProtected {
               error: result.error || new Error(result.reason || "Unknown error")
             });
           } else {
-            this.logger.entity(name).error("Required component failed to start, rolling back", {
-              params: { error: result.error }
-            });
+            this.logger.entity(name).error(
+              "Required component failed to start, rolling back: {{error.message}}",
+              {
+                params: {
+                  error: result.error || new Error(result.reason || "Unknown error")
+                }
+              }
+            );
             await this.rollbackStartup(startedComponents);
             return {
               success: false,
@@ -3227,8 +3240,8 @@ var LifecycleManager = class extends EventEmitterProtected {
       };
     } catch (error) {
       const durationMS = Date.now() - startTime;
-      const err = error;
-      this.logger.entity(name).error("Health check failed", {
+      const err = error instanceof Error ? error : new Error(String(error));
+      this.logger.entity(name).error("Health check failed: {{error.message}}", {
         params: { error: err }
       });
       this.lifecycleEvents.componentHealthCheckFailed(name, err);
@@ -3377,7 +3390,7 @@ var LifecycleManager = class extends EventEmitterProtected {
         result = component.onMessage(payload, from);
       } catch (error) {
         const err = error instanceof Error ? error : new Error(String(error));
-        this.logger.entity(componentName).error("Message handler failed", {
+        this.logger.entity(componentName).error("Message handler failed: {{error.message}}", {
           params: { error: err, from }
         });
         this.lifecycleEvents.componentMessageFailed(componentName, from, err, {
@@ -3437,7 +3450,7 @@ var LifecycleManager = class extends EventEmitterProtected {
       };
     } catch (error) {
       const err = error instanceof Error ? error : new Error(String(error));
-      this.logger.entity(componentName).error("Message handler failed", {
+      this.logger.entity(componentName).error("Message handler failed: {{error.message}}", {
         params: { error: err, from, timeoutMS }
       });
       this.lifecycleEvents.componentMessageFailed(componentName, from, err, {
@@ -3645,7 +3658,7 @@ var LifecycleManager = class extends EventEmitterProtected {
       };
     } catch (error) {
       const err = error instanceof Error ? error : new Error(String(error));
-      this.logger.entity(componentName).error("getValue handler failed", {
+      this.logger.entity(componentName).error("getValue handler failed: {{error.message}}", {
         params: { error: err, key, from }
       });
       this.lifecycleEvents.componentValueReturned(componentName, key, from, {
@@ -3811,9 +3824,13 @@ var LifecycleManager = class extends EventEmitterProtected {
         try {
           startupOrder2 = this.getStartupOrderInternal();
         } catch (error) {
-          this.logger.warn("Failed to compute startup order in error handler", {
-            params: { error }
-          });
+          const err = error instanceof Error ? error : new Error(String(error));
+          this.logger.warn(
+            "Failed to compute startup order in error handler: {{error.message}}",
+            {
+              params: { error: err }
+            }
+          );
           startupOrder2 = [];
         }
         return {
@@ -3977,9 +3994,9 @@ var LifecycleManager = class extends EventEmitterProtected {
         startResult
       };
     } catch (error) {
-      const err = error;
+      const err = error instanceof Error ? error : new Error(String(error));
       const code = err instanceof DependencyCycleError ? "dependency_cycle" : "unknown_error";
-      this.logger.entity(componentName).error("Registration failed with unexpected error", {
+      this.logger.entity(componentName).error("Registration failed with unexpected error: {{error.message}}", {
         params: { error: err }
       });
       this.lifecycleEvents.componentRegistrationRejected({
@@ -4046,10 +4063,11 @@ var LifecycleManager = class extends EventEmitterProtected {
       const startupOrder = this.getStartupOrderInternal();
       shutdownOrder = [...startupOrder].reverse();
     } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
       this.logger.warn(
-        "Could not resolve shutdown order, using registration order",
+        "Could not resolve shutdown order, using registration order: {{error.message}}",
         {
-          params: { error }
+          params: { error: err }
         }
       );
       shutdownOrder = this.components.map((c) => c.getName()).reverse();
@@ -4106,9 +4124,14 @@ var LifecycleManager = class extends EventEmitterProtected {
           if (result2.success) {
             stoppedComponents.push(name);
           } else {
-            this.logger.entity(name).error("Component failed to stop, continuing with others", {
-              params: { error: result2.error }
-            });
+            this.logger.entity(name).error(
+              "Component failed to stop, continuing with others: {{error.message}}",
+              {
+                params: {
+                  error: result2.error || new Error(result2.reason || "Unknown error")
+                }
+              }
+            );
             const stallInfo = this.stalledComponents.get(name);
             if (stallInfo) {
               stalledComponents.push(stallInfo);
@@ -4330,9 +4353,13 @@ var LifecycleManager = class extends EventEmitterProtected {
               try {
                 component.onStartupAborted();
               } catch (error) {
-                this.logger.entity(name).warn("Error in onStartupAborted callback", {
-                  params: { error }
-                });
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.logger.entity(name).warn(
+                  "Error in onStartupAborted callback: {{error.message}}",
+                  {
+                    params: { error: err }
+                  }
+                );
               }
             } else {
               this.monitorLateStartupCompletion(
@@ -4402,11 +4429,11 @@ var LifecycleManager = class extends EventEmitterProtected {
         status: this.getComponentStatus(name)
       };
     } catch (error) {
-      const err = error;
+      const err = error instanceof Error ? error : new Error(String(error));
       this.componentErrors.set(name, err);
       if (err instanceof ComponentStartTimeoutError && err.additionalInfo.componentName === name) {
         this.componentStates.set(name, "starting-timed-out");
-        this.logger.entity(name).error("Component startup timed out", {
+        this.logger.entity(name).error("Component startup timed out: {{error.message}}", {
           params: { error: err }
         });
         this.lifecycleEvents.componentStartTimeout(name, err, {
@@ -4415,7 +4442,7 @@ var LifecycleManager = class extends EventEmitterProtected {
         });
       } else {
         this.componentStates.set(name, "registered");
-        this.logger.entity(name).error("Component failed to start", {
+        this.logger.entity(name).error("Component failed to start: {{error.message}}", {
           params: { error: err }
         });
         this.lifecycleEvents.componentStartFailed(name, err, {
@@ -4547,8 +4574,9 @@ var LifecycleManager = class extends EventEmitterProtected {
         Promise.resolve().then(() => component.onShutdownWarning?.()).then(() => {
           this.lifecycleEvents.componentShutdownWarningCompleted(name);
         }).catch((error) => {
-          this.logger.entity(name).warn("Shutdown warning phase failed", {
-            params: { error }
+          const err = error instanceof Error ? error : new Error(String(error));
+          this.logger.entity(name).warn("Shutdown warning phase failed: {{error.message}}", {
+            params: { error: err }
           });
         });
       }
@@ -4570,8 +4598,9 @@ var LifecycleManager = class extends EventEmitterProtected {
           this.lifecycleEvents.componentShutdownWarningCompleted(name);
         }).catch((error) => {
           statuses.set(name, "rejected");
-          this.logger.entity(name).warn("Shutdown warning phase failed", {
-            params: { error }
+          const err = error instanceof Error ? error : new Error(String(error));
+          this.logger.entity(name).warn("Shutdown warning phase failed: {{error.message}}", {
+            params: { error: err }
           });
         })
       );
@@ -4630,9 +4659,13 @@ var LifecycleManager = class extends EventEmitterProtected {
               try {
                 component.onGracefulStopTimeout();
               } catch (error) {
-                this.logger.entity(name).warn("Error in onGracefulStopTimeout callback", {
-                  params: { error }
-                });
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.logger.entity(name).warn(
+                  "Error in onGracefulStopTimeout callback: {{error.message}}",
+                  {
+                    params: { error: err }
+                  }
+                );
               }
             }
             Promise.resolve(stopPromise).catch(() => {
@@ -4676,7 +4709,7 @@ var LifecycleManager = class extends EventEmitterProtected {
         status: this.getComponentStatus(name)
       };
     } catch (error) {
-      const err = error;
+      const err = error instanceof Error ? error : new Error(String(error));
       this.componentErrors.set(name, err);
       if (err instanceof ComponentStopTimeoutError && err.additionalInfo.componentName === name) {
         this.logger.entity(name).warn("Graceful shutdown timed out");
@@ -4693,7 +4726,7 @@ var LifecycleManager = class extends EventEmitterProtected {
           status: this.getComponentStatus(name)
         };
       } else {
-        this.logger.entity(name).warn("Graceful shutdown threw error", {
+        this.logger.entity(name).warn("Graceful shutdown threw error: {{error.message}}", {
           params: { error: err }
         });
         return {
@@ -4774,9 +4807,13 @@ var LifecycleManager = class extends EventEmitterProtected {
               try {
                 component.onShutdownForceAborted();
               } catch (error) {
-                this.logger.entity(name).warn("Error in onShutdownForceAborted callback", {
-                  params: { error }
-                });
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.logger.entity(name).warn(
+                  "Error in onShutdownForceAborted callback: {{error.message}}",
+                  {
+                    params: { error: err }
+                  }
+                );
               }
             }
             Promise.resolve(forcePromise).catch(() => {
@@ -4816,7 +4853,7 @@ var LifecycleManager = class extends EventEmitterProtected {
         status: this.getComponentStatus(name)
       };
     } catch (error) {
-      const err = error;
+      const err = error instanceof Error ? error : new Error(String(error));
       const isTimeout = err.message === "Force shutdown timed out";
       const stallInfo = {
         name,
@@ -4837,7 +4874,7 @@ var LifecycleManager = class extends EventEmitterProtected {
         });
         this.lifecycleEvents.componentShutdownForceTimeout(name, timeoutMS);
       } else {
-        this.logger.entity(name).error("Force shutdown failed - stalled", {
+        this.logger.entity(name).error("Force shutdown failed - stalled: {{error.message}}", {
           params: { error: err }
         });
       }
@@ -4926,9 +4963,14 @@ var LifecycleManager = class extends EventEmitterProtected {
       this.lifecycleEvents.componentStartupRollback(name);
       const result = await this.stopComponentInternal(name);
       if (!result.success) {
-        this.logger.entity(name).warn("Failed to stop component during rollback, continuing", {
-          params: { error: result.error }
-        });
+        this.logger.entity(name).warn(
+          "Failed to stop component during rollback, continuing: {{error.message}}",
+          {
+            params: {
+              error: result.error || new Error(result.reason || "Unknown error")
+            }
+          }
+        );
       }
     }
     this.logger.info("Rollback completed");
@@ -4991,8 +5033,9 @@ var LifecycleManager = class extends EventEmitterProtected {
     try {
       this.emit(event, data);
     } catch (error) {
-      this.logger.error("Event handler error", {
-        params: { event, error }
+      const err = error instanceof Error ? error : new Error(String(error));
+      this.logger.error("Event handler error: {{error.message}}", {
+        params: { event, error: err }
       });
     }
   }
@@ -5001,9 +5044,13 @@ var LifecycleManager = class extends EventEmitterProtected {
     try {
       startupOrder = this.getStartupOrderInternal();
     } catch (error) {
-      this.logger.warn("Failed to compute startup order in error handler", {
-        params: { error }
-      });
+      const err = error instanceof Error ? error : new Error(String(error));
+      this.logger.warn(
+        "Failed to compute startup order in error handler: {{error.message}}",
+        {
+          params: { error: err }
+        }
+      );
       startupOrder = [];
     }
     return {
@@ -5024,9 +5071,13 @@ var LifecycleManager = class extends EventEmitterProtected {
     try {
       startupOrder = this.getStartupOrderInternal();
     } catch (error) {
-      this.logger.warn("Failed to compute startup order in error handler", {
-        params: { error }
-      });
+      const err = error instanceof Error ? error : new Error(String(error));
+      this.logger.warn(
+        "Failed to compute startup order in error handler: {{error.message}}",
+        {
+          params: { error: err }
+        }
+      );
       startupOrder = [];
     }
     return {
@@ -5420,7 +5471,9 @@ var LifecycleManager = class extends EventEmitterProtected {
         }
       } catch (error) {
         const err = error instanceof Error ? error : new Error(String(error));
-        this.logger.entity(name).error("Reload failed", { params: { error: err } });
+        this.logger.entity(name).error("Reload failed: {{error.message}}", {
+          params: { error: err }
+        });
         this.lifecycleEvents.componentReloadFailed(name, err);
         results.push({
           name,
@@ -5515,7 +5568,9 @@ var LifecycleManager = class extends EventEmitterProtected {
         }
       } catch (error) {
         const err = error instanceof Error ? error : new Error(String(error));
-        this.logger.entity(name).error("Info handler failed", { params: { error: err } });
+        this.logger.entity(name).error("Info handler failed: {{error.message}}", {
+          params: { error: err }
+        });
         this.lifecycleEvents.componentInfoFailed(name, err);
         results.push({
           name,
@@ -5610,7 +5665,9 @@ var LifecycleManager = class extends EventEmitterProtected {
         }
       } catch (error) {
         const err = error instanceof Error ? error : new Error(String(error));
-        this.logger.entity(name).error("Debug handler failed", { params: { error: err } });
+        this.logger.entity(name).error("Debug handler failed: {{error.message}}", {
+          params: { error: err }
+        });
         this.lifecycleEvents.componentDebugFailed(name, err);
         results.push({
           name,