shalomb Hub Safety Protocol
Hub files are imported by 3+ other files. Changes ripple across the codebase.
Before editing
codemap --importers <file>— see all dependents and blast radius- Understand the public API surface: which functions/types are used externally
- Confirm tests exist for dependents, not just the hub itself
While editing
- Prefer additive changes over breaking changes
- If renaming or removing a public symbol, update all importers in the same commit
- If changing a function signature, check every call site
After editing
- Run the full test suite, not just the hub's own tests
codemap --deps .— verify the dependency graph is intact- If 8+ importers, consider staged rollout: change hub → test → update callers separately
Risk escalation
| Importers | Risk | Action |
|---|---|---|
| 3–5 | Medium | Package tests + direct importer tests |
| 6–10 | High | Full test suite, review all importers |
| 10+ | Critical | Consider splitting the hub or introducing an interface |