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

feat(directives): scavenge sweep 2/5 batch 1 (startup+profiling): 2 directives

Browse Source
This commit is contained in:
ed
2026-07-04 01:55:23 -04:00
parent 3fcf7dccb5
commit dd153b1de1
4 changed files with 20 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
conductor/directives/graceful_optional_dependency_degradation/meta.md
+9
View File
@@ -0,0 +1,9 @@
# graceful_optional_dependency_degradation
## v1
**Why this iteration:** Lifted from `docs/superpowers/specs/2026-05-15-profiling-system-design.md` §"Graceful Degradation" (lines 138-143) + the `tracy_integration.py` reference implementation (lines 144-197). When an optional dependency (e.g., `pytracy` for Tracy profiling) is not installed or not connected, the app must continue normally. The pattern: wrap the import in `try/except Exception`, set a module-level `_tracy_available: bool = False` flag, gate every zone call on the flag, log a startup warning. No crash, no feature breakage.
**Source:** `docs/superpowers/specs/2026-05-15-profiling-system-design.md:138-197`
---
**Lifted:** 2026-07-03 (scavenge sweep batch 2/5: docs/superpowers/specs/)
conductor/directives/graceful_optional_dependency_degradation/v1.md
+1
View File
@@ -0,0 +1 @@
# Optional dependencies must degrade gracefully via try/except import + module-level flag pattern