Private
Public Access
0
0

chore: TIER-2 READ conductor/code_styleguides/error_handling.md lines 462-540 (error dropping is NOT a drain) before Phase 2

Re-read for Phase 2:
- 'What is NOT a drain point' (the 5 anti-drains)
  - sys.stderr.write alone
  - logging.error / logger.exception alone
  - return default_value
  - pass (silent)
  - traceback.print_exc alone
- 'Boundary types vs. drain points' (the two concepts are complementary)
- 'The Broad-Except Distinction' table (each catch site classified by
  what it does with the exception)
- 'Heuristic D' (the 5 drain point patterns: HTTP response, GUI popup,
  sys.exit, telemetry, bounded retry)

Key principle applied to Phase 2 inventory: a wrapper that does
def _x(): return _x_result(...).data is equivalent to 'return
default_value' — the structured ErrorInfo is lost. The migration is
to have callers use _x_result(...).ok and route the error to a
documented drain (which may be re-raising, telemetry, or a caller-
specific fallback).
This commit is contained in:
2026-06-20 19:42:08 -04:00
parent 102f219904
commit 0952e883a0

Diff Content Not Available