feat: vendor-neutral error-tracking adapter seam via logger sink

[zaxovaiko]

What

Adds a vendor-neutral ERROR_TRACKING adapter seam so the runtime can report unhandled errors to a vendor (Sentry, PostHog, Rollbar, ...), wired entirely through the logger. Core ships no vendor SDK - the vendor is a consumer overlay.

• Contract (contracts/adapters/error-tracking.ts): ErrorTrackingAdapter port + ERROR_TRACKING token. Fire-and-forget captureException(error, context?) - a reporter failure never breaks the calling path.
• Report through the logger (server/kernel/error-sink.ts + logger.ts): createLogger's pino hook forwards any error-level log carrying err to a process-wide error sink. One logger.error({ err }) both logs and reports - no separate captureException call at each site, and every error log is covered rather than a hand-picked set of seams.
• Bridged in createApp: after plugins load, the sink is wired to whatever ERROR_TRACKING an overlay bound. Unbound -> error logs stay logs-only; the engine imports no vendor SDK and has no SENTRY_DSN of its own.
• Docs (docs/adapters/error-tracking.md) show the Sentry overlay recipe, mirroring the payment/KYC vendor overlays. Regenerated catalog.

Why

The platform had no error/crash reporting - unhandled errors only reached pino/stdout. This adds reporting while keeping core vendor-neutral: a consumer picks Sentry, PostHog, or anything else via an overlay, with zero vendor code shipped to shops that don't use it.

Acceptance

• No overlay bound: error logs stay logs-only, platform unchanged, no vendor SDK loaded.
• Overlay binds ERROR_TRACKING: every logger.error({ err }) is both logged and reported to the vendor.
• Reporter failures are swallowed and never break the calling path.

Verify

pnpm verify green (typecheck + 60 unit tests + lint + module-shape + boundaries); catalog/openapi no-drift. Rebased on dev, conflicts resolved, lockfile unchanged.

[Copilot]

Pull request overview

Adds a vendor-neutral error-tracking “seam” that reports errors via the existing logger pipeline, so consumers can bind a vendor SDK (Sentry/PostHog/Rollbar/…) without core depending on any vendor.

Changes:

• Introduces an ERROR_TRACKING adapter contract (ErrorTrackingAdapter.captureException) and documents how to bind it via an overlay.
• Adds a process-wide error sink (error-sink.ts) and wires createLogger to forward error-level logs containing { err } into that sink (including request context metadata).
• Bridges the sink to the bound adapter in createApp after plugins/configure, and updates the docs catalog.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
pnpm-lock.yaml	Lockfile updated (includes @opentelemetry/api@1.9.1 optional peer entries).
packages/core/src/server/runtime/create-app.ts	Wires the process-wide error sink to the ERROR_TRACKING adapter when present.
packages/core/src/server/kernel/logger.ts	Adds a pino hook to mirror qualifying error logs to the error sink with request context.
packages/core/src/server/kernel/index.ts	Exports setErrorSink/reportError and the ErrorSink type.
packages/core/src/server/kernel/error-sink.ts	Implements the process-wide fire-and-forget error sink.
packages/core/src/server/kernel/tests/logger.test.ts	Adds unit tests for the logger → sink forwarding behavior.
packages/core/src/contracts/adapters/index.ts	Re-exports the error-tracking adapter types and token.
packages/core/src/contracts/adapters/error-tracking.ts	Adds the ErrorTrackingAdapter contract and ERROR_TRACKING token.
docs/catalog.json	Catalog entry for the new adapter seam.
docs/adapters/error-tracking.md	Documentation and example overlay binding (Sentry).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.