feat: initial structure stable release lib observability

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [LerianStudio]

.github/dependabot.yml

@@ -0,0 +1,50 @@
+version: 2
+updates:
+  # Go modules
+  - package-ecosystem: "gomod"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "08:00"
+      timezone: "America/Sao_Paulo"
+    target-branch: "develop"
+    open-pull-requests-limit: 10
+    labels:
+      - "deps"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+    groups:
+      go-dependencies:
+        patterns:
+          - "*"
+
+  # Pinned third-party GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "08:00"
+      timezone: "America/Sao_Paulo"
+    target-branch: "develop"
+    open-pull-requests-limit: 10
+    labels:
+      - "deps"
+      - "ci"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+    ignore:
+      # LerianStudio internal actions are pinned intentionally
+      - dependency-name: "LerianStudio/*"
+    groups:
+      actions-core:
+        patterns:
+          - "actions/*"
+      security-actions:
+        patterns:
+          - "github/codeql-action*"
+          - "aquasecurity/trivy-action"
+          - "securego/gosec"

.github/labeler.yml

@@ -0,0 +1,99 @@
+# Pull Request Labeler configuration
+#
+# Labels are aligned with the pr_title_scopes in pr-validation.yml.
+
+# Assertion helpers
+assert:
+  - changed-files:
+      - any-glob-to-any-file: 'assert/**/*'
+
+# Shared constants
+constants:
+  - changed-files:
+      - any-glob-to-any-file: 'constants/**/*'
+
+# Structured logging primitives
+log:
+  - changed-files:
+      - any-glob-to-any-file: 'log/**/*'
+
+# Metrics instrumentation
+metrics:
+  - changed-files:
+      - any-glob-to-any-file: 'metrics/**/*'
+
+# HTTP/gRPC observability middleware
+middleware:
+  - changed-files:
+      - any-glob-to-any-file: 'middleware/**/*'
+
+# Log/data redaction utilities
+redaction:
+  - changed-files:
+      - any-glob-to-any-file: 'redaction/**/*'
+
+# Runtime introspection
+runtime:
+  - changed-files:
+      - any-glob-to-any-file: 'runtime/**/*'
+
+# Distributed tracing
+tracing:
+  - changed-files:
+      - any-glob-to-any-file: 'tracing/**/*'
+
+# Zap logger integration
+zap:
+  - changed-files:
+      - any-glob-to-any-file: 'zap/**/*'
+
+# Top-level public API (observability.go, system.go, context_helpers.go)
+core:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'observability.go'
+          - 'system.go'
+          - 'context_helpers.go'
+
+# Build and tooling scripts
+scripts:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'scripts/**/*'
+          - 'Makefile'
+
+# Application and tooling configuration
+config:
+  - changed-files:
+      - any-glob-to-any-file:
+          - '.golangci.yml'
+          - '.releaserc.yml'
+          - '.goreleaser.yml'
+          - '.ignorecoverunit'
+
+# Continuous integration pipelines and shared workflows
+ci:
+  - changed-files:
+      - any-glob-to-any-file: '.github/workflows/**/*'
+
+# Markdown docs and llms.txt context files
+docs:
+  - changed-files:
+      - any-glob-to-any-file:
+          - '**/*.md'
+          - 'docs/**/*'
+          - 'llms.txt'
+
+# Unit, integration and end-to-end tests
+tests:
+  - changed-files:
+      - any-glob-to-any-file:
+          - '**/*_test.go'
+          - 'tests/**/*'
+
+# Go module dependencies
+deps:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'go.mod'
+          - 'go.sum'

.github/labels.yml

@@ -0,0 +1,148 @@
+# Label definitions for lib-observability
+# Synced via .github/workflows/routine.yml -> shared labels-sync.
+
+# ── Scopes (aligned with .github/labeler.yml) ─────────────────────────────────
+
+- name: assert
+  color: "1d76db"
+  description: Assertion helpers
+
+- name: constants
+  color: "0e8a16"
+  description: Shared constants
+
+- name: log
+  color: "fbca04"
+  description: Structured logging primitives
+
+- name: metrics
+  color: "c5def5"
+  description: Metrics instrumentation
+
+- name: middleware
+  color: "5319e7"
+  description: HTTP/gRPC observability middleware
+
+- name: redaction
+  color: "7c3aed"
+  description: Log/data redaction utilities
+
+- name: runtime
+  color: "0052cc"
+  description: Runtime introspection
+
+- name: tracing
+  color: "f9d0c4"
+  description: Distributed tracing
+
+- name: zap
+  color: "bfd4f2"
+  description: Zap logger integration
+
+- name: core
+  color: "0db7ed"
+  description: Top-level public API surface
+
+- name: scripts
+  color: "fef2c0"
+  description: Build and tooling scripts
+
+- name: config
+  color: "d4a017"
+  description: Application and tooling configuration
+
+- name: ci
+  color: "2088FF"
+  description: Continuous integration pipelines
+
+- name: docs
+  color: "0075ca"
+  description: Documentation, llms.txt and markdown content
+
+- name: tests
+  color: "00ADD8"
+  description: Unit, integration and end-to-end tests
+
+- name: deps
+  color: "ededed"
+  description: Go module dependencies (usually opened by Dependabot)
+
+# ── Change types ──────────────────────────────────────────────────────────────
+
+- name: bug
+  color: "d73a4a"
+  description: Something is not working as expected
+
+- name: enhancement
+  color: "a2eeef"
+  description: New feature or improvement request
+
+- name: dependencies
+  color: "ededed"
+  description: Dependency updates (Dependabot)
+
+- name: github-actions
+  color: "2088FF"
+  description: Updates to GitHub Actions dependencies
+
+- name: breaking-change
+  color: "b60205"
+  description: Callers must update their integration after this change
+
+- name: skip-changelog
+  color: "ffffff"
+  description: This change does not need a changelog entry
+
+# ── PR size ───────────────────────────────────────────────────────────────────
+
+- name: size/XS
+  color: "3CBF00"
+  description: "PR changes < 50 lines"
+
+- name: size/S
+  color: "5D9801"
+  description: "PR changes 50–199 lines"
+
+- name: size/M
+  color: "7F7203"
+  description: "PR changes 200–499 lines"
+
+- name: size/L
+  color: "A14C05"
+  description: "PR changes 500–999 lines"
+
+- name: size/XL
+  color: "C32607"
+  description: "PR changes ≥ 1000 lines — consider splitting"
+
+# ── Triage and stale management ───────────────────────────────────────────────
+
+- name: triage
+  color: "e4e669"
+  description: Needs initial assessment
+
+- name: stale
+  color: "795548"
+  description: No recent activity — will be closed if not updated
+
+- name: no-stale
+  color: "fef2c0"
+  description: Exempt from stale auto-close
+
+- name: work-in-progress
+  color: "ffa500"
+  description: Active work — exempt from stale auto-close
+
+- name: pinned
+  color: "d4a017"
+  description: Pinned discussion/tracker — exempt from stale auto-close
+
+# ── Automation ────────────────────────────────────────────────────────────────
+
+- name: automated
+  color: "ededed"
+  description: Opened by automation (release backmerges, etc.)
+
+- name: backmerge
+  color: "5319e7"
+  description: Backmerge PR (main → develop after release)

.github/pull_request_template.md

@@ -0,0 +1,59 @@
+<table border="0" cellspacing="0" cellpadding="0">
+  <tr>
+    <td><img src="https://github.com/LerianStudio.png" width="72" alt="Lerian" /></td>
+    <td><h1>Lib Observability</h1></td>
+  </tr>
+</table>
+
+---
+
+## Description
+
+<!-- Summarize what this PR changes and why. Mention the package(s) affected
+     (log, metrics, tracing, middleware, redaction, zap, runtime, assert, ...). -->
+
+## Type of Change
+
+- [ ] `feat`: New feature or capability
+- [ ] `fix`: Bug fix
+- [ ] `perf`: Performance improvement
+- [ ] `refactor`: Internal restructuring with no behavior change
+- [ ] `docs`: Documentation only (README, docs/, inline comments)
+- [ ] `style`: Formatting, whitespace, naming (no logic change)
+- [ ] `test`: Adding or updating tests
+- [ ] `ci`: CI pipeline or workflow changes
+- [ ] `build`: Build system, Go module dependencies
+- [ ] `chore`: Maintenance, config, tooling
+- [ ] `revert`: Reverts a previous commit
+- [ ] `BREAKING CHANGE`: Consumers must update their integration
+
+## Breaking Changes
+
+<!-- If applicable, describe exactly what breaks (public API signatures,
+     exported types, default behaviors, configuration keys) and how downstream
+     services should migrate. Remove this section if not applicable. -->
+
+None.
+
+## Testing
+
+- [ ] `make test` passes
+- [ ] `make test-int` passes if integration paths are exercised
+- [ ] `make lint` passes
+- [ ] Coverage threshold respected (see Go Combined Analysis)
+
+**Test evidence / Actions run:** <!-- Optional: link to a CI run or screenshot -->
+
+## Architectural Checklist
+
+- [ ] No `panic()` in production paths — uses `assert` helpers or wrapped errors
+- [ ] Timestamps use `time.Now().UTC()`
+- [ ] Errors wrapped with `%w`
+- [ ] Public API additions documented (godoc + README if user-facing)
+- [ ] No leaking of context or goroutines (instrumentation must be safe under load)
+- [ ] Backwards-compatible by default; breaking changes flagged above
+- [ ] No `lib-commons` import (circular — see CLAUDE.md)
+
+## Related Issues
+
+Closes #