ring:using-assert

ring:using-assert

Moved from lib-commons

The canonical home for this package is now github.com/LerianStudio/lib-observability/assert. It lived in github.com/LerianStudio/lib-commons/v4/commons/assert and github.com/LerianStudio/lib-commons/v5/commons/assert through the v4 and v5 shim period; lib-commons v5 still re-exports every symbol via type aliases and thin wrappers for backward compatibility, but every type and function in lib-commons/v5/commons/assert is marked Deprecated: and delegates to lib-observability/assert. New code MUST import github.com/LerianStudio/lib-observability/assert. Existing imports continue to compile during the deprecation window — there are no behavior changes, only an import-path move.

When to use

Sweep mode:

• "Sweep the codebase for lib-observability/assert opportunities"
• "Audit this service for zero-panic policy compliance"
• "Find panic()/log.Fatal violations"
• "Replace DIY invariant checks with lib-observability/assert"

Reference mode:

• "What's the signature for assert.DebitsEqualCredits?"
• "How do I initialize assertion metrics?"
• "Should I panic, assert, or return an error here?"
• "How do I unwrap AssertionError in a Fiber error handler?"

Skip when

• Working on non-Go services
• Working on frontend code
• Target codebase is Ring itself

Related

Similar: ring:using-lib-observability, ring:using-runtime Compatibility: ring:using-lib-commons (covers the v5 deprecation shim and re-export aliases)

Mode Selection

Request Shape	Mode
"Sweep / audit for assert opportunities"	Sweep
"Find panic()/log.Fatal() violations"	Sweep
"What's the signature for X?"	Reference
"Should I panic, assert, or return error?"	Reference

---

SWEEP MODE

4-phase sweep. Each phase has a hard gate — do not proceed until the current phase produces its artifact.

Phase 1: Version Reconnaissance   → assert-version-report.json
Phase 2: CHANGELOG Delta Analysis → assert-delta-report.json
Phase 3: Multi-Angle DIY Sweep    → 6 × assert-sweep-{N}-{angle}.json
Phase 4: Consolidated Report      → assert-sweep-report.md + assert-sweep-tasks.json