Logging#

Webette uses a structured, locale-aware logger:

• Levels: debug, info, warn, error (filtered by min level).
• Locales: en, fr (message catalogs in locales/<lang>/logs.json).
• Output: console (rendered), plus .jsonl persistence under <site>/<dirName>/logs.jsonl.
• Scoping: hierarchical (e.g., webette.cli.serve.build).

Configuration#

• Locale and min level come from the tool config (webette.tool.ts) via getEnv() / resolveLocale().
• logging.dirName controls where logs are written inside the site root (default .webette).
• Verbose flag (-v) forces debug min level.

API#

• createProjectLogger(rootDir, scope, verbose) → Logger (async).
• logger.child(scope) → child logger sharing config and log file.
• Methods: debug, info, warn, error accept a messageKey plus optional params.

Messages#

• Keys and templates live in locales/en/logs.json and locales/fr/logs.json.
• Interpolation uses {name} placeholders.

Notes#

• Logs are persisted in neutral format (no rendered text) for future web UI/remote export.
• Locale fallback is normalized; env vars (WEBETTE_LANG/LANG) are only a fallback if the tool config does not set logging.locale.