OUT-4103: make logs readable

[SandipBajracharya]

What

Cleans up logging so output is readable when debugging.

• Single logger that bounds object output (nested depth 2, arrays 10 items, strings 512 chars) so one line can't dump a whole payload or file list.
• LOG_LEVEL env var controls how much prints. Default info. Errors always print and also go to Sentry independent of this.
• All server console.* calls now go through the logger, so the caps and LOG_LEVEL apply everywhere.
• Removed the whole-object/array dumps that made logs unreadable.
• Method-entry breadcrumbs moved to the debug level, so they are off by default and turn back on with LOG_LEVEL=log.

Log levels

log (debug) < info < warn < error. Suggested production value: info.

Testing

• pnpm typecheck clean, Biome clean.
• 280 unit + 179 integration tests passing.

🤖 Generated with Claude Code

[linear-code]

OUT-4103

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
dropbox-integration	Ready	Preview	Aug 27, 2026 12:36pm

[greptile-apps]

Greptile Summary

The PR centralizes server logging behind a bounded, level-aware logger and reduces verbose payload output.

• Adds LOG_LEVEL filtering and bounded object inspection.
• Routes server console calls through the shared logger.
• Moves detailed method-entry logging to the debug level.
• Adds unit coverage for level filtering and output limits.

Confidence Score: 5/5

The PR appears safe to merge because no blocking failure remains.

No blocking failure remains.

Important Files Changed

Filename	Overview
src/lib/logger.ts	Adds level filtering and bounded single-entry formatting to the shared logger.
src/lib/tests/logger.test.ts	Covers filtering defaults and object, array, and string output bounds.
src/features/webhook/dropbox/utils/getDropboxChanges.ts	Routes Dropbox validation and retrieval errors through the shared logger.
src/features/sync/lib/Sync.service.ts	Replaces direct console calls and reduces verbose SQL-condition logging.

_{Reviews (2): Last reviewed commit: "fix(OUT-4103): keep each log on one line..." | Re-trigger Greptile}

[SandipBajracharya]

@greptileai review again