@noego/wood 0.4.7 → 0.4.9

package/bin/wood.js

@@ -40,7 +40,7 @@ const {
 const command = process.argv[2];
 const extraArgs = process.argv.slice(3);
 
-const COMMANDS = ['dev', 'build'];
+const COMMANDS = ['dev', 'build', 'codegen'];
 
 if (!command || !COMMANDS.includes(command)) {
   console.log('Usage: wood <command>');
@@ -48,6 +48,7 @@ if (!command || !COMMANDS.includes(command)) {
   console.log('Commands:');
   console.log('  dev     Generate code and start electron-vite in development mode');
   console.log('  build   Generate code and run electron-vite production build');
+  console.log('  codegen Generate code only, then exit (no electron-vite)');
   console.log('');
   console.log('Options are passed through to electron-vite.');
   process.exit(command ? 1 : 0);
@@ -448,6 +449,11 @@ try {
   process.exit(1);
 }
 
+if (command === 'codegen') {
+  console.log('[wood] Codegen complete');
+  process.exit(0);
+}
+
 // ---------------------------------------------------------------------------
 // 2. Optional dev watcher (YAML + controllers)
 // ---------------------------------------------------------------------------

package/dist/tracing/trace_hub.cjs

@@ -141,6 +141,9 @@ class TraceHub {
     if (this.sinks.size === 0) {
       return;
     }
+    if (traceLevelOrder(level) < traceLevelOrder(this.minLevels.renderer)) {
+      return;
+    }
     const event = {
       ...input,
       level,

package/dist/tracing/trace_hub.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject } from 'rxjs';\nimport { share } from 'rxjs/operators';\nimport type {\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './types/wood_trace_sink.types.js';\n\nexport type StandardTraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceLevel = StandardTraceLevel | (string & {});\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceRuntimeContext = {\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<StandardTraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\nconst CUSTOM_LEVEL_ORDER = LEVEL_ORDER.info;\n\nexport function normalizeTraceLevel(level: unknown, fallback: TraceLevel = 'info'): TraceLevel {\n  if (typeof level !== 'string') {\n    return fallback;\n  }\n\n  const normalized = level.trim().toLowerCase();\n  return normalized.length > 0 ? normalized : fallback;\n}\n\nfunction traceLevelOrder(level: TraceLevel): number {\n  return LEVEL_ORDER[level as StandardTraceLevel] ?? CUSTOM_LEVEL_ORDER;\n}\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet rendererEnabled = false;\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const windowId = typeof input.windowId === 'string' && input.windowId.trim().length > 0\n    ? input.windowId\n    : undefined;\n  const webContentsId = typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n    ? input.webContentsId\n    : undefined;\n  const routeKey = typeof input.routeKey === 'string' && input.routeKey.trim().length > 0\n    ? input.routeKey\n    : undefined;\n  const harnessId = typeof input.harnessId === 'string' && input.harnessId.trim().length > 0\n    ? input.harnessId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(windowId !== undefined ? { windowId } : {}),\n    ...(webContentsId !== undefined ? { webContentsId } : {}),\n    ...(routeKey !== undefined ? { routeKey } : {}),\n    ...(harnessId !== undefined ? { harnessId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction mergeTraceRuntimeContext(input: unknown, context: TraceRuntimeContext | undefined): TraceInput {\n  if (!context) {\n    return normalizeTraceInput(input);\n  }\n  return normalizeTraceInput({\n    ...(isRecord(input) ? input : {}),\n    ...context,\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private readonly sinks = new Set<WoodTraceEventSink>();\n  private nextTraceSeq = 1;\n  private minLevels: Record<TraceProcess, TraceLevel> = {\n    main: 'debug',\n    renderer: 'debug',\n    test: 'debug',\n  };\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(process: TraceProcess, level: TraceLevel): void {\n    this.minLevels[process] = level;\n  }\n\n  registerSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n    this.sinks.add(sink);\n    return () => {\n      this.sinks.delete(sink);\n    };\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (traceLevelOrder(level) >= traceLevelOrder(this.minLevels[process])) {\n      this.publishToSinks(event);\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  publishRendererToSinks(level: TraceLevel, input: TraceInput): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    const event: TraceEvent = {\n      ...input,\n      level,\n      process: 'renderer',\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    this.publishToSinks(event);\n  }\n\n  private publishToSinks(event: TraceEvent): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    const snapshot: WoodTraceEventSnapshot = Object.freeze({\n      ...event,\n      ...(event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}),\n    });\n    for (const sink of this.sinks) {\n      try {\n        sink(snapshot);\n      } catch {\n        // Trace sinks are observational and cannot fail trace callers or peers.\n      }\n    }\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function registerTraceSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n  return getGlobalTraceHub().registerSink(sink);\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel('main', level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n  getGlobalTraceHub().setMinLevel('renderer', level);\n}\n\nexport function setRendererTraceEnabled(enabled: boolean): void {\n  rendererEnabled = enabled;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(\n  rawPayload: unknown,\n  context?: TraceRuntimeContext,\n): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: unknown };\n  const level = normalizeTraceLevel(payload.level);\n  getGlobalTraceHub().publish('renderer', level, mergeTraceRuntimeContext(payload, context));\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (!rendererEnabled) {\n    return;\n  }\n  if (traceLevelOrder(level) < traceLevelOrder(rendererMinLevel)) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n  getGlobalTraceHub().publishRendererToSinks(level, normalized);\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  rendererEnabled = false;\n  customRendererTraceTransport = null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAoC;AACpC,uBAAsB;AA8CtB,MAAM,mBAAmB,uBAAO,IAAI,uBAAuB;AAE3D,MAAM,cAAkD;AAAA,EACtD,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AACT;AACA,MAAM,qBAAqB,YAAY;AAEhC,SAAS,oBAAoB,OAAgB,WAAuB,QAAoB;AAC7F,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,MAAM,KAAK,EAAE,YAAY;AAC5C,SAAO,WAAW,SAAS,IAAI,aAAa;AAC9C;AAEA,SAAS,gBAAgB,OAA2B;AAClD,SAAO,YAAY,KAA2B,KAAK;AACrD;AAEA,IAAI,mBAA+B;AACnC,IAAI,kBAAkB;AACtB,IAAI,+BAAoE;AAmBxE,SAAS,oBAAoB,KAA0B;AACrD,QAAM,QAAS,OAAO,CAAC;AACvB,QAAM,SAAS,OAAO,MAAM,WAAW,YAAY,MAAM,OAAO,KAAK,EAAE,SAAS,IAC5E,MAAM,SACN;AACJ,QAAM,OAAO,OAAO,MAAM,SAAS,YAAY,MAAM,KAAK,KAAK,EAAE,SAAS,IACtE,MAAM,OACN;AACJ,QAAM,UAAU,OAAO,MAAM,YAAY,WAAW,MAAM,UAAU;AACpE,QAAM,iBAAiB,OAAO,MAAM,mBAAmB,YAAY,OAAO,MAAM,mBAAmB,WAC/F,MAAM,iBACN;AACJ,QAAM,WAAW,OAAO,MAAM,aAAa,YAAY,MAAM,SAAS,KAAK,EAAE,SAAS,IAClF,MAAM,WACN;AACJ,QAAM,gBAAgB,OAAO,MAAM,kBAAkB,YAAY,OAAO,SAAS,MAAM,aAAa,IAChG,MAAM,gBACN;AACJ,QAAM,WAAW,OAAO,MAAM,aAAa,YAAY,MAAM,SAAS,KAAK,EAAE,SAAS,IAClF,MAAM,WACN;AACJ,QAAM,YAAY,OAAO,MAAM,cAAc,YAAY,MAAM,UAAU,KAAK,EAAE,SAAS,IACrF,MAAM,YACN;AACJ,QAAM,UAAU,SAAS,MAAM,OAAO,IAAI,EAAE,GAAG,MAAM,QAAQ,IAAI;AAEjE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7B,GAAI,mBAAmB,SAAY,EAAE,eAAe,IAAI,CAAC;AAAA,IACzD,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,IAC7C,GAAI,kBAAkB,SAAY,EAAE,cAAc,IAAI,CAAC;AAAA,IACvD,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,IAC7C,GAAI,cAAc,SAAY,EAAE,UAAU,IAAI,CAAC;AAAA,IAC/C,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B;AACF;AAEA,SAAS,yBAAyB,OAAgB,SAAsD;AACtG,MAAI,CAAC,SAAS;AACZ,WAAO,oBAAoB,KAAK;AAAA,EAClC;AACA,SAAO,oBAAoB;AAAA,IACzB,GAAI,SAAS,KAAK,IAAI,QAAQ,CAAC;AAAA,IAC/B,GAAG;AAAA,EACL,CAAC;AACH;AAEA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,qBAA6C;AACpD,QAAM,YAAY;AAClB,QAAM,SAAS,UAAU,yBACpB,UAAU,QAAQ,yBAClB,UAAU,QACV,UAAU,QAAQ;AACvB,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,MAAM,SAAS;AAAA,EAAf;AACE,SAAiB,UAAU,IAAI,oBAAoB;AACnD,SAAiB,UAAU,KAAK,QAAQ,aAAa,EAAE,SAAK,wBAAM,CAAC;AACnE,SAAiB,QAAQ,oBAAI,IAAwB;AACrD,SAAQ,eAAe;AACvB,SAAQ,YAA8C;AAAA,MACpD,MAAM;AAAA,MACN,UAAU;AAAA,MACV,MAAM;AAAA,IACR;AAAA;AAAA,EAEA,IAAI,UAAkC;AACpC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAY,SAAuB,OAAyB;AAC1D,SAAK,UAAU,OAAO,IAAI;AAAA,EAC5B;AAAA,EAEA,aAAa,MAAiD;AAC5D,SAAK,MAAM,IAAI,IAAI;AACnB,WAAO,MAAM;AACX,WAAK,MAAM,OAAO,IAAI;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,QAAQ,SAAuB,OAAmB,OAA4B;AAC5E,UAAM,aAAa,oBAAoB,KAAK;AAC5C,UAAM,QAAoB;AAAA,MACxB,GAAG;AAAA,MACH;AAAA,MACA;AAAA,MACA,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC,UAAU,KAAK;AAAA,IACjB;AACA,QAAI,gBAAgB,KAAK,KAAK,gBAAgB,KAAK,UAAU,OAAO,CAAC,GAAG;AACtE,WAAK,eAAe,KAAK;AACzB,WAAK,QAAQ,KAAK,KAAK;AAAA,IACzB;AACA,WAAO;AAAA,EACT;AAAA,EAEA,uBAAuB,OAAmB,OAAyB;AACjE,QAAI,KAAK,MAAM,SAAS,GAAG;AACzB;AAAA,IACF;AACA,UAAM,QAAoB;AAAA,MACxB,GAAG;AAAA,MACH;AAAA,MACA,SAAS;AAAA,MACT,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC,UAAU,KAAK;AAAA,IACjB;AACA,SAAK,eAAe,KAAK;AAAA,EAC3B;AAAA,EAEQ,eAAe,OAAyB;AAC9C,QAAI,KAAK,MAAM,SAAS,GAAG;AACzB;AAAA,IACF;AACA,UAAM,WAAmC,OAAO,OAAO;AAAA,MACrD,GAAG;AAAA,MACH,GAAI,MAAM,UAAU,EAAE,SAAS,OAAO,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,EAAE,IAAI,CAAC;AAAA,IAC1E,CAAC;AACD,eAAW,QAAQ,KAAK,OAAO;AAC7B,UAAI;AACF,aAAK,QAAQ;AAAA,MACf,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,oBAA8B;AACrC,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,gBAAgB,GAAG;AAChC,cAAU,gBAAgB,IAAI,IAAI,SAAS;AAAA,EAC7C;AACA,SAAO,UAAU,gBAAgB;AACnC;AAEO,SAAS,kBAA0C;AACxD,SAAO,kBAAkB,EAAE;AAC7B;AAEO,SAAS,kBAAkB,MAAiD;AACjF,SAAO,kBAAkB,EAAE,aAAa,IAAI;AAC9C;AAEO,SAAS,qBAAqB,OAAyB;AAC5D,oBAAkB,EAAE,YAAY,QAAQ,KAAK;AAC/C;AAEO,SAAS,yBAAyB,OAAyB;AAChE,qBAAmB;AACnB,oBAAkB,EAAE,YAAY,YAAY,KAAK;AACnD;AAEO,SAAS,wBAAwB,SAAwB;AAC9D,oBAAkB;AACpB;AAEO,SAAS,iBAAiB,OAAmB,OAA4B;AAC9E,SAAO,kBAAkB,EAAE,QAAQ,QAAQ,OAAO,KAAK;AACzD;AAEO,SAAS,iBAAiB,SAAuB,OAAmB,OAA4B;AACrG,SAAO,kBAAkB,EAAE,QAAQ,SAAS,OAAO,KAAK;AAC1D;AAEO,SAAS,6BACd,YACA,SACqB;AACrB,QAAM,UAAW,cAAc,CAAC;AAChC,QAAM,QAAQ,oBAAoB,QAAQ,KAAK;AAC/C,oBAAkB,EAAE,QAAQ,YAAY,OAAO,yBAAyB,SAAS,OAAO,CAAC;AACzF,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,WAAW;AAAA,EACb;AACF;AAEO,SAAS,0BAA0B,IAA+C;AACvF,iCAA+B;AACjC;AAEO,SAAS,kBAAkB,OAAmB,OAAyB;AAC5E,MAAI,CAAC,iBAAiB;AACpB;AAAA,EACF;AACA,MAAI,gBAAgB,KAAK,IAAI,gBAAgB,gBAAgB,GAAG;AAC9D;AAAA,EACF;AACA,QAAM,aAAa,EAAE,GAAG,oBAAoB,KAAK,GAAG,MAAM;AAC1D,oBAAkB,EAAE,uBAAuB,OAAO,UAAU;AAE5D,MAAI,8BAA8B;AAChC,QAAI;AACF,mCAA6B,UAAU;AACvC;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,QAAM,SAAS,mBAAmB;AAClC,MAAI,CAAC,UAAU,OAAO,OAAO,YAAY,YAAY;AACnD;AAAA,EACF;AACA,MAAI;AACF,WAAO,QAAQ,UAAU;AAAA,EAC3B,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,wBAA8B;AAC5C,QAAM,YAAY;AAClB,SAAO,UAAU,gBAAgB;AACjC,qBAAmB;AACnB,oBAAkB;AAClB,iCAA+B;AACjC;","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject } from 'rxjs';\nimport { share } from 'rxjs/operators';\nimport type {\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './types/wood_trace_sink.types.js';\n\nexport type StandardTraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceLevel = StandardTraceLevel | (string & {});\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceRuntimeContext = {\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<StandardTraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\nconst CUSTOM_LEVEL_ORDER = LEVEL_ORDER.info;\n\nexport function normalizeTraceLevel(level: unknown, fallback: TraceLevel = 'info'): TraceLevel {\n  if (typeof level !== 'string') {\n    return fallback;\n  }\n\n  const normalized = level.trim().toLowerCase();\n  return normalized.length > 0 ? normalized : fallback;\n}\n\nfunction traceLevelOrder(level: TraceLevel): number {\n  return LEVEL_ORDER[level as StandardTraceLevel] ?? CUSTOM_LEVEL_ORDER;\n}\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet rendererEnabled = false;\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const windowId = typeof input.windowId === 'string' && input.windowId.trim().length > 0\n    ? input.windowId\n    : undefined;\n  const webContentsId = typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n    ? input.webContentsId\n    : undefined;\n  const routeKey = typeof input.routeKey === 'string' && input.routeKey.trim().length > 0\n    ? input.routeKey\n    : undefined;\n  const harnessId = typeof input.harnessId === 'string' && input.harnessId.trim().length > 0\n    ? input.harnessId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(windowId !== undefined ? { windowId } : {}),\n    ...(webContentsId !== undefined ? { webContentsId } : {}),\n    ...(routeKey !== undefined ? { routeKey } : {}),\n    ...(harnessId !== undefined ? { harnessId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction mergeTraceRuntimeContext(input: unknown, context: TraceRuntimeContext | undefined): TraceInput {\n  if (!context) {\n    return normalizeTraceInput(input);\n  }\n  return normalizeTraceInput({\n    ...(isRecord(input) ? input : {}),\n    ...context,\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private readonly sinks = new Set<WoodTraceEventSink>();\n  private nextTraceSeq = 1;\n  private minLevels: Record<TraceProcess, TraceLevel> = {\n    main: 'debug',\n    renderer: 'debug',\n    test: 'debug',\n  };\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(process: TraceProcess, level: TraceLevel): void {\n    this.minLevels[process] = level;\n  }\n\n  registerSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n    this.sinks.add(sink);\n    return () => {\n      this.sinks.delete(sink);\n    };\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (traceLevelOrder(level) >= traceLevelOrder(this.minLevels[process])) {\n      this.publishToSinks(event);\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  publishRendererToSinks(level: TraceLevel, input: TraceInput): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    if (traceLevelOrder(level) < traceLevelOrder(this.minLevels.renderer)) {\n      return;\n    }\n    const event: TraceEvent = {\n      ...input,\n      level,\n      process: 'renderer',\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    this.publishToSinks(event);\n  }\n\n  private publishToSinks(event: TraceEvent): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    const snapshot: WoodTraceEventSnapshot = Object.freeze({\n      ...event,\n      ...(event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}),\n    });\n    for (const sink of this.sinks) {\n      try {\n        sink(snapshot);\n      } catch {\n        // Trace sinks are observational and cannot fail trace callers or peers.\n      }\n    }\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function registerTraceSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n  return getGlobalTraceHub().registerSink(sink);\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel('main', level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n  getGlobalTraceHub().setMinLevel('renderer', level);\n}\n\nexport function setRendererTraceEnabled(enabled: boolean): void {\n  rendererEnabled = enabled;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(\n  rawPayload: unknown,\n  context?: TraceRuntimeContext,\n): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: unknown };\n  const level = normalizeTraceLevel(payload.level);\n  getGlobalTraceHub().publish('renderer', level, mergeTraceRuntimeContext(payload, context));\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (!rendererEnabled) {\n    return;\n  }\n  if (traceLevelOrder(level) < traceLevelOrder(rendererMinLevel)) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n  getGlobalTraceHub().publishRendererToSinks(level, normalized);\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  rendererEnabled = false;\n  customRendererTraceTransport = null;\n}\n"],"mappings":"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","names":[]}

package/dist/tracing/trace_hub.js

@@ -107,6 +107,9 @@ class TraceHub {
     if (this.sinks.size === 0) {
       return;
     }
+    if (traceLevelOrder(level) < traceLevelOrder(this.minLevels.renderer)) {
+      return;
+    }
     const event = {
       ...input,
       level,

package/dist/tracing/trace_hub.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject } from 'rxjs';\nimport { share } from 'rxjs/operators';\nimport type {\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './types/wood_trace_sink.types.js';\n\nexport type StandardTraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceLevel = StandardTraceLevel | (string & {});\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceRuntimeContext = {\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<StandardTraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\nconst CUSTOM_LEVEL_ORDER = LEVEL_ORDER.info;\n\nexport function normalizeTraceLevel(level: unknown, fallback: TraceLevel = 'info'): TraceLevel {\n  if (typeof level !== 'string') {\n    return fallback;\n  }\n\n  const normalized = level.trim().toLowerCase();\n  return normalized.length > 0 ? normalized : fallback;\n}\n\nfunction traceLevelOrder(level: TraceLevel): number {\n  return LEVEL_ORDER[level as StandardTraceLevel] ?? CUSTOM_LEVEL_ORDER;\n}\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet rendererEnabled = false;\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const windowId = typeof input.windowId === 'string' && input.windowId.trim().length > 0\n    ? input.windowId\n    : undefined;\n  const webContentsId = typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n    ? input.webContentsId\n    : undefined;\n  const routeKey = typeof input.routeKey === 'string' && input.routeKey.trim().length > 0\n    ? input.routeKey\n    : undefined;\n  const harnessId = typeof input.harnessId === 'string' && input.harnessId.trim().length > 0\n    ? input.harnessId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(windowId !== undefined ? { windowId } : {}),\n    ...(webContentsId !== undefined ? { webContentsId } : {}),\n    ...(routeKey !== undefined ? { routeKey } : {}),\n    ...(harnessId !== undefined ? { harnessId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction mergeTraceRuntimeContext(input: unknown, context: TraceRuntimeContext | undefined): TraceInput {\n  if (!context) {\n    return normalizeTraceInput(input);\n  }\n  return normalizeTraceInput({\n    ...(isRecord(input) ? input : {}),\n    ...context,\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private readonly sinks = new Set<WoodTraceEventSink>();\n  private nextTraceSeq = 1;\n  private minLevels: Record<TraceProcess, TraceLevel> = {\n    main: 'debug',\n    renderer: 'debug',\n    test: 'debug',\n  };\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(process: TraceProcess, level: TraceLevel): void {\n    this.minLevels[process] = level;\n  }\n\n  registerSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n    this.sinks.add(sink);\n    return () => {\n      this.sinks.delete(sink);\n    };\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (traceLevelOrder(level) >= traceLevelOrder(this.minLevels[process])) {\n      this.publishToSinks(event);\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  publishRendererToSinks(level: TraceLevel, input: TraceInput): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    const event: TraceEvent = {\n      ...input,\n      level,\n      process: 'renderer',\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    this.publishToSinks(event);\n  }\n\n  private publishToSinks(event: TraceEvent): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    const snapshot: WoodTraceEventSnapshot = Object.freeze({\n      ...event,\n      ...(event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}),\n    });\n    for (const sink of this.sinks) {\n      try {\n        sink(snapshot);\n      } catch {\n        // Trace sinks are observational and cannot fail trace callers or peers.\n      }\n    }\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function registerTraceSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n  return getGlobalTraceHub().registerSink(sink);\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel('main', level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n  getGlobalTraceHub().setMinLevel('renderer', level);\n}\n\nexport function setRendererTraceEnabled(enabled: boolean): void {\n  rendererEnabled = enabled;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(\n  rawPayload: unknown,\n  context?: TraceRuntimeContext,\n): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: unknown };\n  const level = normalizeTraceLevel(payload.level);\n  getGlobalTraceHub().publish('renderer', level, mergeTraceRuntimeContext(payload, context));\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (!rendererEnabled) {\n    return;\n  }\n  if (traceLevelOrder(level) < traceLevelOrder(rendererMinLevel)) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n  getGlobalTraceHub().publishRendererToSinks(level, normalized);\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  rendererEnabled = false;\n  customRendererTraceTransport = null;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tracing/trace_hub.ts"],"sourcesContent":["import { Observable, Subject } from 'rxjs';\nimport { share } from 'rxjs/operators';\nimport type {\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './types/wood_trace_sink.types.js';\n\nexport type StandardTraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type TraceLevel = StandardTraceLevel | (string & {});\nexport type TraceProcess = 'main' | 'renderer' | 'test';\n\nexport type TraceInput = {\n  source: string;\n  type: string;\n  message?: string;\n  conversationId?: number | string;\n  payload?: Record<string, unknown>;\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceEvent = TraceInput & {\n  level: TraceLevel;\n  process: TraceProcess;\n  timestamp: string;\n  traceSeq: number;\n};\n\nexport type TraceDispatchResult = {\n  ok: boolean;\n  forwarded: boolean;\n};\n\nexport type TraceRuntimeContext = {\n  windowId?: string;\n  webContentsId?: number;\n  routeKey?: string;\n  harnessId?: string;\n};\n\nexport type TraceWaitOptions = {\n  timeoutMs?: number;\n};\n\nconst TRACE_HUB_SYMBOL = Symbol.for('@noego/wood.trace.hub');\n\nconst LEVEL_ORDER: Record<StandardTraceLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\nconst CUSTOM_LEVEL_ORDER = LEVEL_ORDER.info;\n\nexport function normalizeTraceLevel(level: unknown, fallback: TraceLevel = 'info'): TraceLevel {\n  if (typeof level !== 'string') {\n    return fallback;\n  }\n\n  const normalized = level.trim().toLowerCase();\n  return normalized.length > 0 ? normalized : fallback;\n}\n\nfunction traceLevelOrder(level: TraceLevel): number {\n  return LEVEL_ORDER[level as StandardTraceLevel] ?? CUSTOM_LEVEL_ORDER;\n}\n\nlet rendererMinLevel: TraceLevel = 'debug';\nlet rendererEnabled = false;\nlet customRendererTraceTransport: ((payload: unknown) => void) | null = null;\n\ntype GlobalWithTraceHub = typeof globalThis & {\n  [TRACE_HUB_SYMBOL]?: TraceHub;\n};\n\ntype TraceBridgeLike = Record<string, unknown> & {\n  __trace?: (payload: unknown) => void;\n};\n\ntype GlobalWithTraceBridge = typeof globalThis & {\n  __NOEGO_WOOD_BRIDGE__?: unknown;\n  wood?: unknown;\n  window?: {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    wood?: unknown;\n  };\n};\n\nfunction normalizeTraceInput(raw: unknown): TraceInput {\n  const input = (raw ?? {}) as Partial<TraceInput> & Record<string, unknown>;\n  const source = typeof input.source === 'string' && input.source.trim().length > 0\n    ? input.source\n    : 'unknown';\n  const type = typeof input.type === 'string' && input.type.trim().length > 0\n    ? input.type\n    : 'unknown';\n  const message = typeof input.message === 'string' ? input.message : undefined;\n  const conversationId = typeof input.conversationId === 'number' || typeof input.conversationId === 'string'\n    ? input.conversationId\n    : undefined;\n  const windowId = typeof input.windowId === 'string' && input.windowId.trim().length > 0\n    ? input.windowId\n    : undefined;\n  const webContentsId = typeof input.webContentsId === 'number' && Number.isFinite(input.webContentsId)\n    ? input.webContentsId\n    : undefined;\n  const routeKey = typeof input.routeKey === 'string' && input.routeKey.trim().length > 0\n    ? input.routeKey\n    : undefined;\n  const harnessId = typeof input.harnessId === 'string' && input.harnessId.trim().length > 0\n    ? input.harnessId\n    : undefined;\n  const payload = isRecord(input.payload) ? { ...input.payload } : undefined;\n\n  return {\n    source,\n    type,\n    ...(message ? { message } : {}),\n    ...(conversationId !== undefined ? { conversationId } : {}),\n    ...(windowId !== undefined ? { windowId } : {}),\n    ...(webContentsId !== undefined ? { webContentsId } : {}),\n    ...(routeKey !== undefined ? { routeKey } : {}),\n    ...(harnessId !== undefined ? { harnessId } : {}),\n    ...(payload ? { payload } : {}),\n  };\n}\n\nfunction mergeTraceRuntimeContext(input: unknown, context: TraceRuntimeContext | undefined): TraceInput {\n  if (!context) {\n    return normalizeTraceInput(input);\n  }\n  return normalizeTraceInput({\n    ...(isRecord(input) ? input : {}),\n    ...context,\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction resolveTraceBridge(): TraceBridgeLike | null {\n  const globalObj = globalThis as GlobalWithTraceBridge;\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n  return bridge as TraceBridgeLike;\n}\n\nclass TraceHub {\n  private readonly subject = new Subject<TraceEvent>();\n  private readonly shared$ = this.subject.asObservable().pipe(share());\n  private readonly sinks = new Set<WoodTraceEventSink>();\n  private nextTraceSeq = 1;\n  private minLevels: Record<TraceProcess, TraceLevel> = {\n    main: 'debug',\n    renderer: 'debug',\n    test: 'debug',\n  };\n\n  get events$(): Observable<TraceEvent> {\n    return this.shared$;\n  }\n\n  setMinLevel(process: TraceProcess, level: TraceLevel): void {\n    this.minLevels[process] = level;\n  }\n\n  registerSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n    this.sinks.add(sink);\n    return () => {\n      this.sinks.delete(sink);\n    };\n  }\n\n  publish(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n    const normalized = normalizeTraceInput(input);\n    const event: TraceEvent = {\n      ...normalized,\n      level,\n      process,\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    if (traceLevelOrder(level) >= traceLevelOrder(this.minLevels[process])) {\n      this.publishToSinks(event);\n      this.subject.next(event);\n    }\n    return event;\n  }\n\n  publishRendererToSinks(level: TraceLevel, input: TraceInput): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    if (traceLevelOrder(level) < traceLevelOrder(this.minLevels.renderer)) {\n      return;\n    }\n    const event: TraceEvent = {\n      ...input,\n      level,\n      process: 'renderer',\n      timestamp: new Date().toISOString(),\n      traceSeq: this.nextTraceSeq++,\n    };\n    this.publishToSinks(event);\n  }\n\n  private publishToSinks(event: TraceEvent): void {\n    if (this.sinks.size === 0) {\n      return;\n    }\n    const snapshot: WoodTraceEventSnapshot = Object.freeze({\n      ...event,\n      ...(event.payload ? { payload: Object.freeze({ ...event.payload }) } : {}),\n    });\n    for (const sink of this.sinks) {\n      try {\n        sink(snapshot);\n      } catch {\n        // Trace sinks are observational and cannot fail trace callers or peers.\n      }\n    }\n  }\n}\n\nfunction getGlobalTraceHub(): TraceHub {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  if (!globalObj[TRACE_HUB_SYMBOL]) {\n    globalObj[TRACE_HUB_SYMBOL] = new TraceHub();\n  }\n  return globalObj[TRACE_HUB_SYMBOL] as TraceHub;\n}\n\nexport function getTraceEvents$(): Observable<TraceEvent> {\n  return getGlobalTraceHub().events$;\n}\n\nexport function registerTraceSink(sink: WoodTraceEventSink): WoodTraceSinkDisposer {\n  return getGlobalTraceHub().registerSink(sink);\n}\n\nexport function setMainTraceMinLevel(level: TraceLevel): void {\n  getGlobalTraceHub().setMinLevel('main', level);\n}\n\nexport function setRendererTraceMinLevel(level: TraceLevel): void {\n  rendererMinLevel = level;\n  getGlobalTraceHub().setMinLevel('renderer', level);\n}\n\nexport function setRendererTraceEnabled(enabled: boolean): void {\n  rendererEnabled = enabled;\n}\n\nexport function publishMainTrace(level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish('main', level, input);\n}\n\nexport function publishTestTrace(process: TraceProcess, level: TraceLevel, input: unknown): TraceEvent {\n  return getGlobalTraceHub().publish(process, level, input);\n}\n\nexport function dispatchRendererTracePayload(\n  rawPayload: unknown,\n  context?: TraceRuntimeContext,\n): TraceDispatchResult {\n  const payload = (rawPayload ?? {}) as Partial<TraceInput> & { level?: unknown };\n  const level = normalizeTraceLevel(payload.level);\n  getGlobalTraceHub().publish('renderer', level, mergeTraceRuntimeContext(payload, context));\n  return {\n    ok: true,\n    forwarded: true,\n  };\n}\n\nexport function setRendererTraceTransport(fn: ((payload: unknown) => void) | null): void {\n  customRendererTraceTransport = fn;\n}\n\nexport function emitRendererTrace(level: TraceLevel, input: TraceInput): void {\n  if (!rendererEnabled) {\n    return;\n  }\n  if (traceLevelOrder(level) < traceLevelOrder(rendererMinLevel)) {\n    return;\n  }\n  const normalized = { ...normalizeTraceInput(input), level };\n  getGlobalTraceHub().publishRendererToSinks(level, normalized);\n\n  if (customRendererTraceTransport) {\n    try {\n      customRendererTraceTransport(normalized);\n      return;\n    } catch {\n      // Fall through to bridge.__trace\n    }\n  }\n\n  const bridge = resolveTraceBridge();\n  if (!bridge || typeof bridge.__trace !== 'function') {\n    return;\n  }\n  try {\n    bridge.__trace(normalized);\n  } catch {\n    // Tracing is observational and must never break the caller.\n  }\n}\n\nexport function clearTraceHubForTests(): void {\n  const globalObj = globalThis as GlobalWithTraceHub;\n  delete globalObj[TRACE_HUB_SYMBOL];\n  rendererMinLevel = 'debug';\n  rendererEnabled = false;\n  customRendererTraceTransport = null;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noego/wood",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,9 +20,11 @@
     "loaders",
     "docs",
     "src/components/",
+    "src/client/app_env.ts",
     "src/client/controller_contract.ts",
     "src/controller/controller_lifecycle.ts",
-    "src/navigation/navigation_identity.ts"
+    "src/navigation/navigation_identity.ts",
+    "src/runtime/app_env.ts"
   ],
   "exports": {
     ".": {

package/src/client/app_env.ts

@@ -0,0 +1,21 @@
+import type { WoodAppEnv } from '../runtime/app_env.js';
+
+export type { WoodAppEnv };
+
+// Stored on globalThis because this module is loaded twice at runtime: once in
+// wood's bundled dist (startWood) and once as raw source via the Svelte
+// component exports (NavigationShell); a module-local variable would not be shared.
+const CLIENT_APP_ENV_SYMBOL = Symbol.for('@noego/wood.client.app-env');
+
+type GlobalWithAppEnv = typeof globalThis & { [CLIENT_APP_ENV_SYMBOL]?: WoodAppEnv };
+
+export function setWoodAppEnv(value: unknown): void {
+  if (value === 'dev' || value === 'local' || value === 'packaged') {
+    (globalThis as GlobalWithAppEnv)[CLIENT_APP_ENV_SYMBOL] = value;
+  }
+}
+
+/** Environment tier of the running app, resolved by the main process during startWood boot. */
+export function getWoodAppEnv(): WoodAppEnv {
+  return (globalThis as GlobalWithAppEnv)[CLIENT_APP_ENV_SYMBOL] ?? 'packaged';
+}

package/src/runtime/app_env.ts

@@ -0,0 +1,27 @@
+export type WoodAppEnv = 'dev' | 'local' | 'packaged';
+
+/**
+ * Resolve the runtime environment tier for the running app:
+ * - 'dev'      — launched via `wood dev` (WOOD_MODE=development in the env)
+ * - 'local'    — built output run directly (`electron .`), not packaged
+ * - 'packaged' — installed/packaged app (electron-forge etc.)
+ */
+export async function resolveWoodAppEnv(
+  env: NodeJS.ProcessEnv = process.env,
+): Promise<WoodAppEnv> {
+  // ELECTRON_RENDERER_URL is set by electron-vite dev (same signal wood uses to
+  // choose loadURL vs loadFile); WOOD_MODE covers the wood CLI child env.
+  if (env.WOOD_MODE === 'development' || env.ELECTRON_RENDERER_URL) {
+    return 'dev';
+  }
+  try {
+    const electron = await import('electron');
+    const app = (electron as { app?: { isPackaged?: boolean } }).app;
+    if (app && app.isPackaged === false) {
+      return 'local';
+    }
+  } catch {
+    // Electron unavailable (tests/node) — treat as packaged so no ribbon shows.
+  }
+  return 'packaged';
+}