Function runtimeDebug

src/core/runtime-debug.ts:62–80

(scope: string, message: string, detail?: unknown)

}

export function runtimeDebug(scope: string, message: string, detail?: unknown): void {
  try {
    ensureDebugDir();
    const time = new Date().toISOString();
    const suffix = detail === undefined ? '' : ` | ${detailToString(detail)}`;
    const formatted = `${time} pid=${process.pid} [${scope}] ${message} | ${runtimeMemorySummary()}${suffix}`;
    // Rotate log if it exceeds the size limit
    try {
      const stat = fs.statSync(DEBUG_LOG_FILE);
      if (stat.size > MAX_LOG_SIZE) {
        fs.truncateSync(DEBUG_LOG_FILE, 0);
      }
    } catch { /* file doesn't exist yet — that's fine */ }
    fs.appendFileSync(DEBUG_LOG_FILE, formatted + '\n', 'utf-8');
    if (outputHook) outputHook(formatted);
  } catch {
    // Best-effort only.
  }
}

export function installRuntimeDebugHooks(scope = 'extension-host'): void {
  const globalObj = globalThis as Record<string, unknown>;