ed/manual_slop
Private
Public Access
0
0
Fork 0
Code Activity

docs(app_controller+guidelines): add Exception Handling section + audit script cross-reference

Browse Source
This commit is contained in:
ed
2026-06-16 09:07:24 -04:00
parent b447f66818
commit 4209523228
2 changed files with 94 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
conductor/product-guidelines.md
+10
View File
@@ -71,6 +71,16 @@ tracks will apply it to the remaining `src/` files
see `conductor/tracks/data_oriented_error_handling_20260606/spec.md` §12.2
for the prioritized list).
**Audit:** the convention is enforced via
[`scripts/audit_exception_handling.py`](../../scripts/audit_exception_handling.py)
(static analyzer; file-presence = enabled per
[`feature_flags.md`](code_styleguides/feature_flags.md)). Run
`uv run python scripts/audit_exception_handling.py` for a human-readable
report or `--json` for machine-readable output. The audit classifies each
`try/except/finally/raise` site against 10 categories (5 compliant + 3
violation + 1 suspicious + 1 unclear); see the styleguide's "Audit Script"
section for the full taxonomy.
### `Optional[T]` ban (return types only)
In the 3 refactored files (`src/mcp_client.py`, `src/ai_client.py`,