feat: v0.2.0 — add ErrAny for recover() payloads

[maxence2997]

Summary

• Add ErrAny(v any) []zap.Field for non-error panic recovery values (recover() returns any).
• Clarify in README the relationship between ecsf.Err, single-field error helpers, and zap.Error(err) when paired with the ecszap encoder.

Why

Surfaced from streaming-observer dogfooding of v0.1.0:

1. Panic recovery code had to manually do fmt.Sprint(recovered) + fmt.Sprintf("%T", recovered) because Err(error) doesn't accept any. ErrAny removes that boilerplate and delegates to Err when the value is actually an error.
2. The README didn't make clear that zap.Error(err) under ecszap already produces ECS-shaped output, almost causing unnecessary scope creep when migrating call sites.

API

// Returns nil for nil input. Delegates to Err() when v satisfies error
// (so stack_trace works for StackTracer errors). Otherwise emits
// error.message = fmt.Sprint(v), error.type = fmt.Sprintf("%T", v).
func ErrAny(v any) []zap.Field

Typical panic recovery:

defer func() {
    if r := recover(); r != nil {
        fields := ecsf.ErrAny(r)
        fields = append(fields, ecsf.ErrorStackTrace(debug.Stack()))
        logger.Error("panic recovered", fields...)
    }
}()

Test plan

• make check passes (fmt + lint + race-detector test)
• New tests cover: nil, plain error, StackTracer error, string, int, struct
• CI green

[Copilot]

Pull request overview

Adds a new zap subpackage helper to extract ECS error.* fields from recover() payloads (typed as any), and updates documentation to clarify how ecsfields error helpers relate to zap.Error(err) when using the ecszap encoder.

Changes:

• Introduce ErrAny(v any) to emit ECS error fields for non-error panic payloads while delegating to Err(err) when possible.
• Add unit tests covering ErrAny for nil, error, stack-tracer error, and several non-error payload types.
• Update README, ECS coverage docs, and CHANGELOG for v0.2.0 and the new helper.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
zap/error.go	Adds ErrAny(any) helper for recover() payloads and documents intended usage.
zap/error_test.go	Adds tests validating ErrAny behavior across error and non-error inputs.
README.md	Updates coverage counts and documents how to choose between ecsf.Err* helpers and zap.Error.
docs/ecs-coverage.md	Updates coverage matrix to include ErrAny() and bumps version label/count.
CHANGELOG.md	Adds v0.2.0 entry describing ErrAny and the documentation clarification.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 7 comments.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.