@trebired/logger 2.5.6 → 2.5.11

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to `@trebired/logger` will be documented here.
 
 This project follows semantic versioning once published.
 
+## 2.5.9
+
+- Added package-owned organization metadata and derived logger package notices from `package.json`.
+- Kept browser-facing logger constants free of package metadata filesystem reads.
+- Updated internal package dependency ranges to the current sibling package releases.
+
+## 2.5.8
+
+- Removed dead test scripts and stale test commands from publish workflows and maintainer docs.
+
+## 2.5.7
+
+- Removed package test suites and banned committed `*.spec.ts`/`*.spec.tsx` files through Code Discipline.
+- Added Code Discipline enforcement for hardcoded `trebired` strings outside package metadata.
+- Migrated Code Discipline to `.code-discipline/config.ts` with alias-map sync output.
+- Updated package-generated artifact ignores and internal package dependency ranges.
+
 ## 2.5.6
 
 - Moved package-owned logger startup notices under the `trebired.logger.initialize` group root while leaving caller-supplied log groups unchanged.
@@ -128,3 +145,5 @@ This project follows semantic versioning once published.
 - Added group-based JSONL storage with ISO-style filenames.
 - Added retention cleanup, max-size rolling, optional gzip compression, redaction, serializers, sampling, request middleware, stream events, and query helpers.
 - Initial public release.
+
+- Standardized package metadata ordering and contributing guidance around the Trebired writing style.

package/README.md

@@ -6,28 +6,14 @@ Local-first JSONL logger with human-browsable group folders, durable writes, ret
 
 ## Install
 
-Runtime support: Bun 1+ and Node.js 18+.
-
-The package can use bundled native binaries for supported Linux and macOS targets to speed up large storage/export workloads. Consumers still install a single package:
-
-```txt
-@trebired/logger
-  dist/
-  native/
-    linux-x64-gnu.node
-    linux-arm64-gnu.node
-    darwin-arm64.node
-    darwin-x64.node
-```
-
-At runtime the JS wrapper always tries the matching `.node` file first when one is bundled for the current platform, and falls back to the built-in JS backend if native loading is unavailable or fails. Bundled native binaries are currently published for Linux GNU (`x64` and `arm64`) and macOS targets. End users do not need Rust installed.
-
-Set `TB_LOGGER_DISABLE_NATIVE=1` only when you explicitly want to force the JS backend.
+Runtime support: Bun 1+.
 
 ```sh
-npm install @trebired/logger
+bun i @trebired/logger
 ```
 
+## Quick Start
+
 ```ts
 import { createLog } from "@trebired/logger";
 
@@ -48,58 +34,9 @@ import { createBrowserLog } from "@trebired/logger/browser";
 import { LogProvider, useLog } from "@trebired/logger/browser/react";
 ```
 
-## Browser Runtime
-
-Use `@trebired/logger/browser` when you want the same levels, metadata conventions, grouping rules, and scoped logger behavior in browser code:
-
-```ts
-import { createBrowserLog } from "@trebired/logger/browser";
-
-const log = createBrowserLog({
-  group: "frontend.app",
-  metadata: {
-    deploymentId: "deploy-42",
-    requestId: "req-abc",
-  },
-});
-
-log.info("frontend boot");
-await log.flush();
-```
-
-The first browser release ships with console delivery built in. It also supports custom browser transports with in-memory batching so you can add fetch, beacon, websocket, or other delivery later without changing the logger API.
-
-There is no built-in SSR bootstrap helper in this release. If you want browser correlation data such as `requestId`, `sessionId`, or `deploymentId`, pass it explicitly through `metadata` or per-log metadata.
-
-## React Adapter
-
-`@trebired/logger/browser/react` is intentionally thin. It does not create a logger for you. It only helps wire an existing browser logger into React context:
-
-```tsx
-import { createRoot } from "react-dom/client";
-import { createBrowserLog } from "@trebired/logger/browser";
-import { LogProvider, useLog } from "@trebired/logger/browser/react";
-
-const log = createBrowserLog({
-  group: "frontend.app",
-  metadata: { deploymentId: "deploy-42" },
-});
-
-function SaveButton() {
-  const scopedLog = useLog("ui.save_button");
-  return <button onClick={() => scopedLog.info("clicked")}>Save</button>;
-}
-
-createRoot(document.getElementById("root")!).render(
-  <LogProvider log={log}>
-    <SaveButton />
-  </LogProvider>,
-);
-```
-
-`LogErrorBoundary` is also available from `@trebired/logger/browser/react` when you want render errors logged with the shared event shape.
+## Concepts
 
-## Why This Logger
+### Why This Logger
 
 Most loggers either write to stdout and expect an external collector, or provide a very broad transport system. This package is intentionally opinionated around a simpler operational workflow:
 
@@ -176,7 +113,7 @@ If you already have a full custom partition string, pass it directly with `parti
 
 Temporary partitions are now self-cleaning: once a logger switches away from a temporary partition, promotes it, or closes, any temporary partition in that log directory that is no longer current is deleted automatically.
 
-If you want the logger to own the common “temp first, final later” lifecycle, call `finalizePartition()` instead of open-coding a `promotePartition()` plus fallback sequence:
+If you want the logger to own the common "temp first, final later" lifecycle, call `finalizePartition()` instead of open-coding a `promotePartition()` plus fallback sequence:
 
 ```ts
 const result = await log.finalizePartition(final, {
@@ -188,140 +125,7 @@ if (result.action === "switched") {
 }
 ```
 
-## Partition Lifecycle
-
-You can manage partitions either from a live logger or with standalone helpers:
-
-```ts
-import {
-  copyPartition,
-  createPartition,
-  deleteLogs,
-  getPartitionInfo,
-  listPartitions,
-  renamePartition,
-} from "@trebired/logger";
-
-await createPartition("/var/log/my-app", "2026-05-17-12-00-00-1-staged", {
-  temporary: true,
-});
-
-const partitions = await listPartitions("/var/log/my-app");
-console.log(partitions.total.megabytes);
-console.log(partitions[0]?.total.megabytes);
-
-await renamePartition("/var/log/my-app", {
-  from: "2026-05-17-12-00-00-1-staged",
-  to: "2026-05-17-12-00-00-1-final",
-});
-
-await copyPartition({
-  fromDir: "/var/log/my-app",
-  from: "2026-05-17-12-00-00-1-final",
-  toDir: "/var/log/archive",
-  to: "2026-05-17-12-00-00-1-final-copy",
-});
-
-await deleteLogs("/var/log/my-app", {
-  partition: "2026-05-17-12-00-00-1-final",
-  groupKey: "jobs.queue",
-  level: "warn",
-  olderThanDays: 7,
-});
-
-console.log(await getPartitionInfo("/var/log/my-app", "2026-05-17-12-00-00-1-final"));
-```
-
-For live loggers, the package now exposes two layers:
-
-- `promotePartition()` stays the lower-level explicit primitive. By default it still errors on target conflicts unless you pass `merge: true` or `ifExists`.
-- `finalizePartition()` is the higher-level lifecycle helper for idempotent temp-to-final transitions.
-
-`finalizePartition()` returns structured outcomes instead of forcing application code to catch expected conflicts:
-
-```ts
-const result = await log.finalizePartition("2026-05-17-12-00-00-1-final", {
-  ifExists: "switch",
-});
-
-result.action;
-// "renamed" | "merged" | "switched" | "activated-target"
-// "marked-permanent" | "already-finalized"
-```
-
-Conflict policies:
-
-- `ifExists: "error"` keeps strict low-level behavior
-- `ifExists: "merge"` merges the active source partition into the existing target
-- `ifExists: "switch"` activates the existing target without merging the current source
-
-For advanced callers that still use the lower-level primitives directly, `getPartitionErrorCode()` and `isPartitionError()` can inspect partition lifecycle errors without parsing raw message strings.
-
-## Core API
-
-```ts
-const log = createLog({
-  dir: "/var/log/my-app",
-  save: true,
-  console: true,
-  timeZone: "America/New_York",
-  source: "api",
-});
-
-log.debug("app.boot", "config loaded");
-log.info("app.boot", "ready");
-log.success("job.import", "finished", { rows: 1200 });
-log.warn("http.request", "slow request", { took_ms: 842 });
-log.fail("job.import", "failed validation");
-log.error("app.runtime", "uncaught error");
-```
-
-`save` defaults to `true` when `dir` is provided. If no `dir` is provided, the logger can still emit console output and live stream events.
-
-If you log without passing a group, the logger always uses `"default"`.
-
-`@trebired/logger` runs on both Bun and Node.js. It may print one-time package notices for runtime-specific guidance or important future package messages. For example, when it detects Node.js, it recommends Bun for best startup and file I/O performance. Pass `quiet: true` to suppress package notices:
-
-```ts
-const log = createLog({
-  quiet: true,
-});
-```
-
-When `quiet` is not `true`, the package also prints a one-time startup greeting using the same console logger style as normal entries.
-
-`timeZone` is a top-level logger option because it controls the actual local moment used for saved file names and console timestamps. It defaults to the host timezone, then falls back to `America/New_York`.
-
-Console output is configurable. `level` and `message` are always shown; timestamp, group, and metadata can be hidden. `console.locale` only controls display formatting. When `locale` is omitted or invalid, the logger passes `undefined` to `Intl.DateTimeFormat`, so JavaScript uses the runtime or system default locale:
-
-```ts
-const log = createLog({
-  timeZone: "America/New_York",
-  console: {
-    colors: true,
-    timestamp: true,
-    group: false,
-    metadata: false,
-    locale: "en-US",
-  },
-});
-```
-
-Use `timeZone` for the local hour and `console.locale` for the display style.
-
-Server runtimes also auto-discover a top-level `tb.logger.json` file by walking up from `process.cwd()`. When present, it overrides console group visibility in both development and production without affecting saved logs:
-
-```json
-{
-  "hideConsoleGroups": ["blog.post", "http.request"]
-}
-```
-
-Each configured group hides both the exact group and descendants such as `blog.post.comment`. Invalid files print a warning and are ignored.
-
-European dot-date locales such as `cs-CZ` and `de-DE` are formatted consistently as `03.05.2026, 15:59:23`.
-
-## Full API Example
+### Full API Example
 
 ```ts
 import { createLog } from "@trebired/logger";
@@ -395,7 +199,7 @@ await log.flush();
 await log.close();
 ```
 
-## Custom Levels
+### Custom Levels
 
 Levels are weighted. `minLevel` filters out entries with lower weight.
 
@@ -416,7 +220,183 @@ Built-in levels are `debug`, `info`, `success`, `warn`, `fail`, and `error`. A c
 
 Custom level methods are available at runtime. In TypeScript, the logger exposes dynamic level methods through an index signature, so custom names work but are not exhaustively autocompleted from the `levels` object yet.
 
-## Async Writes, Flush, and Close
+### Scoped Loggers
+
+```ts
+const jobs = log.group("jobs.queue");
+jobs.info("started", { jobId: "job_1" });
+
+const worker = log.withScope("worker", "jobs.queue", 2);
+worker.error("failed", { jobId: "job_1" });
+```
+
+### Express-Style Middleware
+
+`requestLogger()` is compatible with Express-style middleware and attaches `req.log` by default.
+
+```ts
+app.use(log.requestLogger({
+  group: "http.request",
+  idHeader: "x-request-id",
+}));
+
+app.get("/", (req, res) => {
+  req.log.info("handled");
+  res.end("ok");
+});
+```
+
+### Live Stream
+
+```ts
+import { logStream } from "@trebired/logger";
+
+logStream.on("log", (entry, context) => {
+  // context.dir is the active log directory, if one is configured
+});
+```
+
+## Runtime
+
+### Install Notes
+
+The package can use bundled native binaries for supported Linux and macOS targets to speed up large storage/export workloads. Consumers still install a single package:
+
+```txt
+@trebired/logger
+  dist/
+  native/
+    linux-x64-gnu.node
+    linux-arm64-gnu.node
+    darwin-arm64.node
+    darwin-x64.node
+```
+
+At runtime the JS wrapper always tries the matching `.node` file first when one is bundled for the current platform, and falls back to the built-in JS backend if native loading is unavailable or fails. Bundled native binaries are currently published for Linux GNU (`x64` and `arm64`) and macOS targets. End users do not need Rust installed.
+
+Set `TB_LOGGER_DISABLE_NATIVE=1` only when you explicitly want to force the JS backend.
+
+### Browser Runtime
+
+Use `@trebired/logger/browser` when you want the same levels, metadata conventions, grouping rules, and scoped logger behavior in browser code:
+
+```ts
+import { createBrowserLog } from "@trebired/logger/browser";
+
+const log = createBrowserLog({
+  group: "frontend.app",
+  metadata: {
+    deploymentId: "deploy-42",
+    requestId: "req-abc",
+  },
+});
+
+log.info("frontend boot");
+await log.flush();
+```
+
+The first browser release ships with console delivery built in. It also supports custom browser transports with in-memory batching so you can add fetch, beacon, websocket, or other delivery later without changing the logger API.
+
+There is no built-in SSR bootstrap helper in this release. If you want browser correlation data such as `requestId`, `sessionId`, or `deploymentId`, pass it explicitly through `metadata` or per-log metadata.
+
+### React Adapter
+
+`@trebired/logger/browser/react` is intentionally thin. It does not create a logger for you. It only helps wire an existing browser logger into React context:
+
+```tsx
+import { createRoot } from "react-dom/client";
+import { createBrowserLog } from "@trebired/logger/browser";
+import { LogProvider, useLog } from "@trebired/logger/browser/react";
+
+const log = createBrowserLog({
+  group: "frontend.app",
+  metadata: { deploymentId: "deploy-42" },
+});
+
+function SaveButton() {
+  const scopedLog = useLog("ui.save_button");
+  return <button onClick={() => scopedLog.info("clicked")}>Save</button>;
+}
+
+createRoot(document.getElementById("root")!).render(
+  <LogProvider log={log}>
+    <SaveButton />
+  </LogProvider>,
+);
+```
+
+`LogErrorBoundary` is also available from `@trebired/logger/browser/react` when you want render errors logged with the shared event shape.
+
+### Partition Lifecycle
+
+You can manage partitions either from a live logger or with standalone helpers:
+
+```ts
+import {
+  copyPartition,
+  createPartition,
+  deleteLogs,
+  getPartitionInfo,
+  listPartitions,
+  renamePartition,
+} from "@trebired/logger";
+
+await createPartition("/var/log/my-app", "2026-05-17-12-00-00-1-staged", {
+  temporary: true,
+});
+
+const partitions = await listPartitions("/var/log/my-app");
+console.log(partitions.total.megabytes);
+console.log(partitions[0]?.total.megabytes);
+
+await renamePartition("/var/log/my-app", {
+  from: "2026-05-17-12-00-00-1-staged",
+  to: "2026-05-17-12-00-00-1-final",
+});
+
+await copyPartition({
+  fromDir: "/var/log/my-app",
+  from: "2026-05-17-12-00-00-1-final",
+  toDir: "/var/log/archive",
+  to: "2026-05-17-12-00-00-1-final-copy",
+});
+
+await deleteLogs("/var/log/my-app", {
+  partition: "2026-05-17-12-00-00-1-final",
+  groupKey: "jobs.queue",
+  level: "warn",
+  olderThanDays: 7,
+});
+
+console.log(await getPartitionInfo("/var/log/my-app", "2026-05-17-12-00-00-1-final"));
+```
+
+For live loggers, the package now exposes two layers:
+
+- `promotePartition()` stays the lower-level explicit primitive. By default it still errors on target conflicts unless you pass `merge: true` or `ifExists`.
+- `finalizePartition()` is the higher-level lifecycle helper for idempotent temp-to-final transitions.
+
+`finalizePartition()` returns structured outcomes instead of forcing application code to catch expected conflicts:
+
+```ts
+const result = await log.finalizePartition("2026-05-17-12-00-00-1-final", {
+  ifExists: "switch",
+});
+
+result.action;
+// "renamed" | "merged" | "switched" | "activated-target"
+// "marked-permanent" | "already-finalized"
+```
+
+Conflict policies:
+
+- `ifExists: "error"` keeps strict low-level behavior
+- `ifExists: "merge"` merges the active source partition into the existing target
+- `ifExists: "switch"` activates the existing target without merging the current source
+
+For advanced callers that still use the lower-level primitives directly, `getPartitionErrorCode()` and `isPartitionError()` can inspect partition lifecycle errors without parsing raw message strings.
+
+### Async Writes, Flush, and Close
 
 File writes are async queued by default.
 
@@ -452,7 +432,7 @@ const log = createLog({
 });
 ```
 
-## Retention and Rolling
+### Retention and Rolling
 
 Defaults:
 
@@ -484,7 +464,7 @@ When a file exceeds the configured size, the logger rolls to the next sequence i
 2026-05-03-13-00-00-3-info.jsonl
 ```
 
-## Redaction and Serializers
+### Redaction and Serializers
 
 Common sensitive keys are redacted by default: password, token, secret, authorization, cookie, api_key, and related variants.
 
@@ -506,33 +486,7 @@ log.info("account.update", "saved", {
 });
 ```
 
-## Scoped Loggers
-
-```ts
-const jobs = log.group("jobs.queue");
-jobs.info("started", { jobId: "job_1" });
-
-const worker = log.withScope("worker", "jobs.queue", 2);
-worker.error("failed", { jobId: "job_1" });
-```
-
-## Express-Style Middleware
-
-`requestLogger()` is compatible with Express-style middleware and attaches `req.log` by default.
-
-```ts
-app.use(log.requestLogger({
-  group: "http.request",
-  idHeader: "x-request-id",
-}));
-
-app.get("/", (req, res) => {
-  req.log.info("handled");
-  res.end("ok");
-});
-```
-
-## Query Saved Logs
+### Query Saved Logs
 
 Old query names are not supported anymore. Use `getLogsForDir()`, `getAllLogs()`, and `getAllLogsAcrossPartitions()`. Do not use `getEntriesForDir()` or `getAll()`.
 
@@ -574,7 +528,7 @@ console.log(merged.logs);
 console.log(merged.metadata.partitions.items);
 ```
 
-## Sampling
+### Sampling
 
 ```ts
 const log = createLog({
@@ -586,26 +540,91 @@ const selective = createLog({
 });
 ```
 
-## Live Stream
-
-```ts
-import { logStream } from "@trebired/logger";
-
-logStream.on("log", (entry, context) => {
-  // context.dir is the active log directory, if one is configured
-});
-```
-
-## Development
+### Development
 
 ```sh
 bun install
 bun run demo
-bun test
 bun run typecheck
 bun run build
 ```
 
+Committed `*.spec.ts` and `*.spec.tsx` files are banned by Code Discipline, so this package does not expose a test script.
+
 `bun run demo` starts a small dummy system that keeps logging until interrupted. It exercises grouped and scoped loggers, custom levels, redaction, request middleware, live stream events, local querying, and write stats. It writes throwaway logs into the repo under `.demo-logs/dummy`. Microslop Windows is not supported.
 
-The npm package exports compiled files from `dist`. Publishing runs `typecheck`, tests, and `build` through `prepublishOnly`.
+The published package exports compiled files from `dist`. Publishing runs `typecheck` and package verification through `prepublishOnly`.
+
+## Public API
+
+### Core API
+
+```ts
+const log = createLog({
+  dir: "/var/log/my-app",
+  save: true,
+  console: true,
+  timeZone: "America/New_York",
+  source: "api",
+});
+
+log.debug("app.boot", "config loaded");
+log.info("app.boot", "ready");
+log.success("job.import", "finished", { rows: 1200 });
+log.warn("http.request", "slow request", { took_ms: 842 });
+log.fail("job.import", "failed validation");
+log.error("app.runtime", "uncaught error");
+```
+
+`save` defaults to `true` when `dir` is provided. If no `dir` is provided, the logger can still emit console output and live stream events.
+
+If you log without passing a group, the logger always uses `"default"`.
+
+`@trebired/logger` runs on both Bun. It may print one-time package notices for runtime-specific guidance or important future package messages. For example, Pass `quiet: true` to suppress package notices:
+
+```ts
+const log = createLog({
+  quiet: true,
+});
+```
+
+When `quiet` is not `true`, the package also prints a one-time startup greeting using the same console logger style as normal entries.
+
+`timeZone` is a top-level logger option because it controls the actual local moment used for saved file names and console timestamps. It defaults to the host timezone, then falls back to `America/New_York`.
+
+Console output is configurable. `level` and `message` are always shown; timestamp, group, and metadata can be hidden. `console.locale` only controls display formatting. When `locale` is omitted or invalid, the logger passes `undefined` to `Intl.DateTimeFormat`, so JavaScript uses the runtime or system default locale:
+
+```ts
+const log = createLog({
+  timeZone: "America/New_York",
+  console: {
+    colors: true,
+    timestamp: true,
+    group: false,
+    metadata: false,
+    locale: "en-US",
+  },
+});
+```
+
+Use `timeZone` for the local hour and `console.locale` for the display style.
+
+Server runtimes also auto-discover a top-level `tb.logger.json` file by walking up from `process.cwd()`. When present, it overrides console group visibility in both development and production without affecting saved logs:
+
+```json
+{
+  "hideConsoleGroups": ["blog.post", "http.request"]
+}
+```
+
+Each configured group hides both the exact group and descendants such as `blog.post.comment`. Invalid files print a warning and are ignored.
+
+European dot-date locales such as `cs-CZ` and `de-DE` are formatted consistently as `03.05.2026, 15:59:23`.
+
+## What It Does Not Do
+
+This package does not:
+
+- replace a full observability stack
+- force one transport, server framework, or deployment model
+- infer product-specific redaction policy

package/dist/config/console_visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console_visibility.d.ts","sourceRoot":"","sources":["../../src/config/console_visibility.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,gBAAgB,mBAAmB,CAAC;AAE1C,KAAK,gCAAgC,GAAG;IACtC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,KAAK,uBAAuB,GAAG,gCAAgC,GAAG;IAChE,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC,CAAC;AAoFF,iBAAS,gCAAgC,CAAC,QAAQ,SAAgB,GAAG,gCAAgC,CAWpG;AAgBD,iBAAS,8BAA8B,CAAC,QAAQ,SAAgB,GAAG,uBAAuB,CAGzF;AAED,OAAO,EACL,gBAAgB,EAChB,gCAAgC,EAChC,8BAA8B,GAC/B,CAAC;AACF,YAAY,EACV,uBAAuB,EACvB,gCAAgC,GACjC,CAAC"}
+{"version":3,"file":"console_visibility.d.ts","sourceRoot":"","sources":["../../src/config/console_visibility.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,gBAAgB,mBAAmB,CAAC;AAG1C,KAAK,gCAAgC,GAAG;IACtC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,KAAK,uBAAuB,GAAG,gCAAgC,GAAG;IAChE,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC,CAAC;AAoFF,iBAAS,gCAAgC,CAAC,QAAQ,SAAgB,GAAG,gCAAgC,CAWpG;AAgBD,iBAAS,8BAA8B,CAAC,QAAQ,SAAgB,GAAG,uBAAuB,CAGzF;AAED,OAAO,EACL,gBAAgB,EAChB,gCAAgC,EAChC,8BAA8B,GAC/B,CAAC;AACF,YAAY,EACV,uBAAuB,EACvB,gCAAgC,GACjC,CAAC"}

package/dist/config/console_visibility.js

@@ -3,17 +3,19 @@ import path from "node:path";
 import { normGroup } from "../groups.js";
 import { resolveNativeConsoleVisibilityConfig } from "../storage/backend/native.js";
 import { isPlainObject } from "../utils/values.js";
+import { buildPackageLogGroup } from "../package-metadata.js";
 const CONFIG_FILE_NAME = "tb.logger.json";
+const LOGGER_LOG_GROUP = buildPackageLogGroup();
 function warningForInvalidShape(filePath) {
-    return `[trebired.logger] invalid ${CONFIG_FILE_NAME} at ${filePath}: expected an object with a hideConsoleGroups string array`;
+    return `[${LOGGER_LOG_GROUP}] invalid ${CONFIG_FILE_NAME} at ${filePath}: expected an object with a hideConsoleGroups string array`;
 }
 function warningForReadError(filePath, error) {
     const detail = error instanceof Error ? error.message : String(error);
-    return `[trebired.logger] failed to read ${CONFIG_FILE_NAME} at ${filePath}: ${detail}`;
+    return `[${LOGGER_LOG_GROUP}] failed to read ${CONFIG_FILE_NAME} at ${filePath}: ${detail}`;
 }
 function warningForParseError(filePath, error) {
     const detail = error instanceof Error ? error.message : String(error);
-    return `[trebired.logger] invalid JSON in ${CONFIG_FILE_NAME} at ${filePath}: ${detail}`;
+    return `[${LOGGER_LOG_GROUP}] invalid JSON in ${CONFIG_FILE_NAME} at ${filePath}: ${detail}`;
 }
 function normalizeHideConsoleGroups(input) {
     const out = [];

package/dist/config/console_visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"console_visibility.js","sourceRoot":"","sources":["../../src/config/console_visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,oCAAoC,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAY1C,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,OAAO,6BAA6B,gBAAgB,OAAO,QAAQ,4DAA4D,CAAC;AAClI,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB,EAAE,KAAc;IAC3D,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,oCAAoC,gBAAgB,OAAO,QAAQ,KAAK,MAAM,EAAE,CAAC;AAC1F,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAgB,EAAE,KAAc;IAC5D,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,qCAAqC,gBAAgB,OAAO,QAAQ,KAAK,MAAM,EAAE,CAAC;AAC3F,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAe;IACjD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;QACxC,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEtD,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACvD,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE;gBAAE,OAAO,SAAS,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QAEV,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,IAAI,GAAG,EAAE,CAAC;IAEd,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,UAAU,EAAE,QAAQ;YACpB,iBAAiB,EAAE,EAAE;YACrB,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC;SAC9C,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,UAAU,EAAE,QAAQ;YACpB,iBAAiB,EAAE,EAAE;YACrB,OAAO,EAAE,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC;SAC/C,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC5I,OAAO;YACL,UAAU,EAAE,QAAQ;YACpB,iBAAiB,EAAE,EAAE;YACrB,OAAO,EAAE,sBAAsB,CAAC,QAAQ,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU,EAAE,QAAQ;QACpB,iBAAiB,EAAE,0BAA0B,CAAC,MAAM,CAAC,iBAAiB,CAAC;QACvE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,SAAS,gCAAgC,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,iBAAiB,EAAE,EAAE;YACrB,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,YAAY,CAAC,OAAyC;IAC7D,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhI,OAAO;QACL,UAAU,EAAE,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;QAC9E,iBAAiB;QACjB,OAAO,EAAE,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QACxF,UAAU,CAAC,KAAa;YACtB,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;YACxC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,UAAU,KAAK,WAAW,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC;QACzH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9D,MAAM,aAAa,GAAG,oCAAoC,CAAC,QAAQ,CAAC,CAAC;IACrE,OAAO,YAAY,CAAC,aAAa,IAAI,gCAAgC,CAAC,QAAQ,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,OAAO,EACL,gBAAgB,EAChB,gCAAgC,EAChC,8BAA8B,GAC/B,CAAC"}
+{"version":3,"file":"console_visibility.js","sourceRoot":"","sources":["../../src/config/console_visibility.ts"],"names":[],"mappings":"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"}