@yadsh/dsh-plugin-log 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-plugins contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @yadsh/dsh-plugin-log
+
+Structured JSON or readable-text file logging for server-side DeepSeek Harness
+plugins, with daily rotation, retention, console mirroring, and runtime
+discovery.
+
+```ts
+import {
+  getPluginLogger,
+  getRegisteredPluginLoggers,
+  setPluginLogFormat,
+  setPluginLogLevel,
+  subscribePluginLoggerRegistry,
+} from "@yadsh/dsh-plugin-log";
+
+const log = getPluginLogger({ pluginId: "dsh-example" });
+log.info("example.ready");
+
+const unsubscribe = subscribePluginLoggerRegistry((loggers) => {
+  console.info("active logger consumers", loggers);
+});
+
+setPluginLogLevel("dsh-example", "debug");
+setPluginLogFormat("text");
+unsubscribe();
+await log.close();
+```
+
+The registry is process-wide and tracks active logger instances automatically.
+`@yadsh/dsh-plugin-log-ui` uses it to provide live defaults, per-plugin level
+overrides, and a `json`/`text` selector in DSH settings.
+See the repository's
+[`docs/PLUGIN_LOGGING.md`](https://github.com/xarleyn/dsh-plugins/blob/main/docs/PLUGIN_LOGGING.md)
+for the complete behavior and API contract.
+
+## Development
+
+```bash
+pnpm --filter @yadsh/dsh-plugin-log check
+```
+
+## License
+
+MIT

package/lib/dsh-home.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DSH home resolution for plugin runtime helpers.
+ *
+ * Kept free of DSH runtime dependencies so the logger can be used by any
+ * server-side package.
+ */
+/**
+ * Resolve the DSH home directory: `$DSH_HOME` when set to a non-blank value,
+ * otherwise `~/.dsh` (the same convention as `dsh-draft-sessions` storage).
+ */
+export declare function resolveDshHome(env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=dsh-home.d.ts.map

package/lib/dsh-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-home.d.ts","sourceRoot":"","sources":["../src/dsh-home.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG3E"}

package/lib/dsh-home.js

@@ -0,0 +1,17 @@
+/**
+ * DSH home resolution for plugin runtime helpers.
+ *
+ * Kept free of DSH runtime dependencies so the logger can be used by any
+ * server-side package.
+ */
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+/**
+ * Resolve the DSH home directory: `$DSH_HOME` when set to a non-blank value,
+ * otherwise `~/.dsh` (the same convention as `dsh-draft-sessions` storage).
+ */
+export function resolveDshHome(env = process.env) {
+    const configured = env.DSH_HOME?.trim();
+    return configured ? resolve(configured) : join(homedir(), ".dsh");
+}
+//# sourceMappingURL=dsh-home.js.map

package/lib/dsh-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-home.js","sourceRoot":"","sources":["../src/dsh-home.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACxC,OAAO,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public server-side API for `@yadsh/dsh-plugin-log`.
+ */
+export * from "./dsh-home.js";
+export * from "./plugin-logger.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}

package/lib/index.js

@@ -0,0 +1,6 @@
+/**
+ * Public server-side API for `@yadsh/dsh-plugin-log`.
+ */
+export * from "./dsh-home.js";
+export * from "./plugin-logger.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}

package/lib/plugin-logger.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Shared file logger for server-side DSH plugins. The wrapper:
+ *
+ * - wraps `pino` for severity levels and JSON/text serialization;
+ * - writes daily files `<dir>/<YYYY-MM-DD>.log`, by default under
+ *   `<$DSH_HOME>/logs/<pluginId>`;
+ * - mirrors selected records to an injectable console sink (default level
+ *   `warn`) so operators still see problems live;
+ * - never throws at runtime: file-system failures degrade to console-only
+ *   logging (fail-open), and closed loggers silently drop records;
+ * - disables file output when `DSH_LOG_DISABLED=1`, and under `NODE_ENV=test`
+ *   unless `dir` is set explicitly (unit tests never touch a real home).
+ *
+ * Record shape (one JSON object per line): pino's `level` (numeric),
+ * `time` (epoch ms) and `msg` (= the event code), plus `plugin` and the
+ * caller's fields; `child(module)` adds `module`. Reserved pino keys
+ * (`level`, `time`, `msg`, `plugin`, `module`) must not be used as field
+ * names.
+ */
+/** Ordered severity levels; `silent` disables the logger entirely. */
+export declare const PLUGIN_LOG_LEVELS: readonly ["trace", "debug", "info", "warn", "error", "fatal", "silent"];
+export type PluginLogLevel = (typeof PLUGIN_LOG_LEVELS)[number];
+/** File serialization formats. JSON is NDJSON; text is one readable line. */
+export declare const PLUGIN_LOG_FORMATS: readonly ["json", "text"];
+export type PluginLogFormat = (typeof PLUGIN_LOG_FORMATS)[number];
+/** Every level except `silent` (which also disables the console mirror). */
+export type ConsoleLevel = Exclude<PluginLogLevel, "silent">;
+/**
+ * Receives console-mirrored records. Must not throw; the wrapper guards every
+ * call regardless.
+ */
+export type PluginConsoleSink = (level: ConsoleLevel, message: string) => void;
+/** Default console mirror threshold. */
+export declare const DEFAULT_CONSOLE_LEVEL: PluginLogLevel;
+/** Daily log files kept per plugin by default (0 = keep forever). */
+export declare const DEFAULT_LOG_RETENTION_DAYS = 14;
+/** Type guard for level strings (config parsing, env overrides). */
+export declare function isPluginLogLevel(value: unknown): value is PluginLogLevel;
+/** Type guard for file serialization format strings. */
+export declare function isPluginLogFormat(value: unknown): value is PluginLogFormat;
+/** Logger configuration; every field except `pluginId` is optional. */
+export interface PluginLoggerOptions {
+    /**
+     * Plugin id: directory name, `plugin` record field and env-prefix source
+     * (`DSH_LOG_LEVEL_<ID>`). Must match `[A-Za-z0-9][A-Za-z0-9._-]*`.
+     */
+    readonly pluginId: string;
+    /** Severity threshold. Default: `DSH_LOG_LEVEL_<ID>` / `DSH_LOG_LEVEL` env, else `info`. */
+    readonly level?: PluginLogLevel;
+    /** File serialization format. Default: `json`. */
+    readonly format?: PluginLogFormat;
+    /** Absolute log directory. Default: `<$DSH_HOME>/logs/<pluginId>`. */
+    readonly dir?: string;
+    /** Overrides the DSH home used to build the default `dir` (tests). */
+    readonly dshHome?: string;
+    /** Console mirror threshold; `silent` disables mirroring. Default: `warn`. */
+    readonly console?: PluginLogLevel;
+    /** Mirror target. Default: the global `console`. */
+    readonly consoleSink?: PluginConsoleSink;
+    /** Daily files older than this are deleted on rollover. Default: 14; 0 disables. */
+    readonly retentionDays?: number;
+    /** Master switch for file output. Default: auto (see the module docs). */
+    readonly file?: boolean;
+    /** Record fields to redact (pino `redact` paths), e.g. `["apiKey"]`. */
+    readonly redact?: readonly string[];
+    /** Clock for file naming, rollover and retention (tests). */
+    readonly now?: () => number;
+}
+/** Stable logging surface shared by server-side plugins. */
+export interface PluginLogger {
+    trace(event: string, fields?: Record<string, unknown>): void;
+    debug(event: string, fields?: Record<string, unknown>): void;
+    info(event: string, fields?: Record<string, unknown>): void;
+    warn(event: string, fields?: Record<string, unknown>): void;
+    error(event: string, fields?: Record<string, unknown>): void;
+    fatal(event: string, fields?: Record<string, unknown>): void;
+    /** Bound sub-logger that adds a `module` field to every record. */
+    child(module: string): PluginLogger;
+    /** Current severity threshold. */
+    get level(): PluginLogLevel;
+    /** Change the severity threshold at runtime. */
+    setLevel(level: PluginLogLevel): void;
+    /** Current file serialization format. */
+    get format(): PluginLogFormat;
+    /** Change the file serialization format at runtime. */
+    setFormat(format: PluginLogFormat): void;
+    /** Best-effort synchronous flush of buffered file output. */
+    flush(): void;
+    /** Flush and close the destination; idempotent; later writes are dropped. */
+    close(): Promise<void>;
+}
+/** Runtime metadata exposed to logging-settings and diagnostics consumers. */
+export interface RegisteredPluginLogger {
+    /** Process-local identity of this root logger instance. */
+    readonly registrationId: number;
+    readonly pluginId: string;
+    readonly dir: string;
+    readonly level: PluginLogLevel;
+    readonly format: PluginLogFormat;
+}
+/** Receives a complete snapshot whenever the process-wide registry changes. */
+export type PluginLoggerRegistryListener = (loggers: readonly RegisteredPluginLogger[]) => void;
+/** Snapshot of every active root logger, sorted for deterministic UI output. */
+export declare function getRegisteredPluginLoggers(): readonly RegisteredPluginLogger[];
+/**
+ * Subscribe to registry snapshots. The listener is called immediately and
+ * after registration, close, or a level change. Returns an idempotent cleanup.
+ */
+export declare function subscribePluginLoggerRegistry(listener: PluginLoggerRegistryListener): () => void;
+/** Change the level of every active logger owned by `pluginId`. */
+export declare function setPluginLogLevel(pluginId: string, level: PluginLogLevel): number;
+/** Change the format of every active plugin logger. */
+export declare function setPluginLogFormat(format: PluginLogFormat): number;
+/** Create a standalone logger instance (no caching). */
+export declare function createPluginLogger(options: PluginLoggerOptions): PluginLogger;
+/**
+ * Create or return the cached logger for `pluginId` + resolved `dir`. A later
+ * call with an explicit `level` updates the cached instance's threshold, so
+ * plugin config reloads take effect. `close()` evicts the cache entry; the
+ * next call creates a fresh instance.
+ */
+export declare function getPluginLogger(options: PluginLoggerOptions): PluginLogger;
+//# sourceMappingURL=plugin-logger.d.ts.map

package/lib/plugin-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-logger.d.ts","sourceRoot":"","sources":["../src/plugin-logger.ts"],"names":[],"mappings":"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"}

package/lib/plugin-logger.js

@@ -0,0 +1,625 @@
+/**
+ * Shared file logger for server-side DSH plugins. The wrapper:
+ *
+ * - wraps `pino` for severity levels and JSON/text serialization;
+ * - writes daily files `<dir>/<YYYY-MM-DD>.log`, by default under
+ *   `<$DSH_HOME>/logs/<pluginId>`;
+ * - mirrors selected records to an injectable console sink (default level
+ *   `warn`) so operators still see problems live;
+ * - never throws at runtime: file-system failures degrade to console-only
+ *   logging (fail-open), and closed loggers silently drop records;
+ * - disables file output when `DSH_LOG_DISABLED=1`, and under `NODE_ENV=test`
+ *   unless `dir` is set explicitly (unit tests never touch a real home).
+ *
+ * Record shape (one JSON object per line): pino's `level` (numeric),
+ * `time` (epoch ms) and `msg` (= the event code), plus `plugin` and the
+ * caller's fields; `child(module)` adds `module`. Reserved pino keys
+ * (`level`, `time`, `msg`, `plugin`, `module`) must not be used as field
+ * names.
+ */
+import { mkdirSync } from "node:fs";
+import { readdir, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { Writable } from "node:stream";
+import pino from "pino";
+import { resolveDshHome } from "./dsh-home.js";
+/** Ordered severity levels; `silent` disables the logger entirely. */
+export const PLUGIN_LOG_LEVELS = [
+    "trace",
+    "debug",
+    "info",
+    "warn",
+    "error",
+    "fatal",
+    "silent",
+];
+/** File serialization formats. JSON is NDJSON; text is one readable line. */
+export const PLUGIN_LOG_FORMATS = ["json", "text"];
+/** Default console mirror threshold. */
+export const DEFAULT_CONSOLE_LEVEL = "warn";
+/** Daily log files kept per plugin by default (0 = keep forever). */
+export const DEFAULT_LOG_RETENTION_DAYS = 14;
+const LEVEL_WEIGHT = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+};
+const DAY_MS = 86_400_000;
+const LOG_FILE_PATTERN = /^(\d{4}-\d{2}-\d{2})\.log$/;
+function weightOf(level) {
+    return level === "silent" ? Number.POSITIVE_INFINITY : LEVEL_WEIGHT[level];
+}
+/** Type guard for level strings (config parsing, env overrides). */
+export function isPluginLogLevel(value) {
+    return typeof value === "string" && PLUGIN_LOG_LEVELS.includes(value);
+}
+/** Type guard for file serialization format strings. */
+export function isPluginLogFormat(value) {
+    return typeof value === "string" && PLUGIN_LOG_FORMATS.includes(value);
+}
+const REGISTRY_SYMBOL = Symbol.for("@yadsh/dsh-plugin-log/registry/v1");
+function registryState() {
+    const globalObject = globalThis;
+    const existing = globalObject[REGISTRY_SYMBOL];
+    if (existing?.version === 1)
+        return existing;
+    const created = {
+        version: 1,
+        nextRegistrationId: 1,
+        cache: new Map(),
+        active: new Map(),
+        listeners: new Set(),
+    };
+    globalObject[REGISTRY_SYMBOL] = created;
+    return created;
+}
+/** Snapshot of every active root logger, sorted for deterministic UI output. */
+export function getRegisteredPluginLoggers() {
+    const snapshots = [];
+    for (const [registrationId, core] of registryState().active) {
+        if (core.isClosed())
+            continue;
+        snapshots.push(Object.freeze({
+            registrationId,
+            pluginId: core.pluginId,
+            dir: core.dir,
+            level: core.level,
+            format: core.format,
+        }));
+    }
+    return Object.freeze(snapshots.sort((left, right) => left.pluginId.localeCompare(right.pluginId) ||
+        left.dir.localeCompare(right.dir) ||
+        left.registrationId - right.registrationId));
+}
+function notifyRegistryListeners() {
+    const state = registryState();
+    const snapshot = getRegisteredPluginLoggers();
+    for (const listener of state.listeners) {
+        try {
+            listener(snapshot);
+        }
+        catch {
+            // Registry observers must never affect logging or plugin execution.
+        }
+    }
+}
+/**
+ * Subscribe to registry snapshots. The listener is called immediately and
+ * after registration, close, or a level change. Returns an idempotent cleanup.
+ */
+export function subscribePluginLoggerRegistry(listener) {
+    const listeners = registryState().listeners;
+    listeners.add(listener);
+    try {
+        listener(getRegisteredPluginLoggers());
+    }
+    catch {
+        // Keep the registry fail-open just like the logger itself.
+    }
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/** Change the level of every active logger owned by `pluginId`. */
+export function setPluginLogLevel(pluginId, level) {
+    if (!isPluginLogLevel(level)) {
+        throw new TypeError(`unknown plugin log level: ${JSON.stringify(level)}`);
+    }
+    let updated = 0;
+    for (const core of registryState().active.values()) {
+        if (!core.isClosed() && core.pluginId === pluginId) {
+            core.setLevel(level);
+            updated += 1;
+        }
+    }
+    return updated;
+}
+/** Change the format of every active plugin logger. */
+export function setPluginLogFormat(format) {
+    if (!isPluginLogFormat(format)) {
+        throw new TypeError(`unknown plugin log format: ${JSON.stringify(format)}`);
+    }
+    let updated = 0;
+    for (const core of registryState().active.values()) {
+        if (!core.isClosed()) {
+            core.setFormat(format);
+            updated += 1;
+        }
+    }
+    return updated;
+}
+function formatConsole(event, fields) {
+    if (fields === undefined)
+        return event;
+    const parts = Object.entries(fields).map(([key, value]) => {
+        const rendered = typeof value === "string" ? value : JSON.stringify(value);
+        return `${key}=${rendered}`;
+    });
+    return parts.length === 0 ? event : `${event} ${parts.join(" ")}`;
+}
+/** Local-calendar date stamp used in file names (sorts lexically). */
+function dayStamp(ms) {
+    const date = new Date(ms);
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${date.getFullYear()}-${month}-${day}`;
+}
+function envLevelOverride(pluginId) {
+    const env = process.env;
+    const specific = env[`DSH_LOG_LEVEL_${pluginId.replaceAll("-", "_").toUpperCase()}`];
+    if (isPluginLogLevel(specific))
+        return specific;
+    return isPluginLogLevel(env.DSH_LOG_LEVEL) ? env.DSH_LOG_LEVEL : undefined;
+}
+function envFileDisabled(explicitDir) {
+    const flag = process.env.DSH_LOG_DISABLED ?? process.env.DSH_PLUGIN_LOG_DISABLED;
+    if (flag === "1" || flag === "true")
+        return true;
+    // Unit tests must never write into a real DSH home unless a dir is explicit.
+    return process.env.NODE_ENV === "test" && !explicitDir;
+}
+async function sweepOldLogFiles(dir, retentionDays, nowMs) {
+    if (retentionDays <= 0)
+        return;
+    const cutoff = nowMs - retentionDays * DAY_MS;
+    const entries = await readdir(dir).catch(() => []);
+    for (const entry of entries) {
+        const match = LOG_FILE_PATTERN.exec(entry);
+        if (match === null || match[1] === undefined)
+            continue;
+        const stampMs = Date.parse(`${match[1]}T00:00:00`);
+        if (!Number.isFinite(stampMs) || stampMs >= cutoff)
+            continue;
+        await unlink(join(dir, entry)).catch(() => undefined);
+    }
+}
+const LEVEL_LABEL = new Map(Object.entries(LEVEL_WEIGHT).map(([level, weight]) => [weight, level.toUpperCase()]));
+function textValue(value) {
+    if (typeof value === "string")
+        return JSON.stringify(value);
+    const rendered = JSON.stringify(value);
+    return rendered === undefined ? String(value) : rendered;
+}
+function renderTextRecord(line) {
+    try {
+        const record = JSON.parse(line);
+        const time = typeof record["time"] === "number"
+            ? new Date(record["time"]).toISOString()
+            : String(record["time"] ?? "-");
+        const numericLevel = typeof record["level"] === "number" ? record["level"] : Number.NaN;
+        const level = (LEVEL_LABEL.get(numericLevel) ?? String(record["level"] ?? "LOG")).padEnd(5);
+        const plugin = String(record["plugin"] ?? "unknown");
+        const module = typeof record["module"] === "string" ? `/${record["module"]}` : "";
+        const event = String(record["msg"] ?? "");
+        const reserved = new Set(["level", "time", "plugin", "module", "msg"]);
+        const fields = Object.entries(record)
+            .filter(([key]) => !reserved.has(key))
+            .map(([key, value]) => `${key}=${textValue(value)}`);
+        return `${time} ${level} [${plugin}${module}] ${event}${fields.length === 0 ? "" : ` ${fields.join(" ")}`}\n`;
+    }
+    catch {
+        return `${line}\n`;
+    }
+}
+/** Converts pino NDJSON chunks to readable lines before the file destination. */
+class TextDestination extends Writable {
+    target;
+    buffered = "";
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+    _write(chunk, _encoding, callback) {
+        try {
+            this.buffered += chunk.toString();
+            this.writeCompleteLines();
+            callback();
+        }
+        catch (error) {
+            callback(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    _final(callback) {
+        try {
+            if (this.buffered.length > 0) {
+                this.target.write(renderTextRecord(this.buffered));
+                this.buffered = "";
+            }
+            if (this.target.destroyed === true) {
+                callback();
+                return;
+            }
+            if (this.target.once !== undefined) {
+                this.target.once("close", callback);
+                this.target.end?.();
+            }
+            else {
+                this.target.end?.();
+                callback();
+            }
+        }
+        catch (error) {
+            callback(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    flushSync() {
+        this.writeCompleteLines();
+        this.target.flushSync?.();
+    }
+    writeCompleteLines() {
+        let newline = this.buffered.indexOf("\n");
+        while (newline >= 0) {
+            const line = this.buffered.slice(0, newline);
+            this.buffered = this.buffered.slice(newline + 1);
+            if (line.length > 0)
+                this.target.write(renderTextRecord(line));
+            newline = this.buffered.indexOf("\n");
+        }
+    }
+}
+let sharedDevNull;
+function devNull() {
+    sharedDevNull ??= new Writable({
+        write(_chunk, _encoding, callback) {
+            callback();
+        },
+    });
+    return sharedDevNull;
+}
+function closeQuietly(destination) {
+    try {
+        destination.end?.();
+    }
+    catch {
+        // Fail-open: closing must never surface.
+    }
+}
+/**
+ * SonicBoom's `end()` takes no callback — completion is signaled by the
+ * `close` event. A bounded guard keeps a wedged stream from hanging plugin
+ * disposal forever.
+ */
+function closeDestination(destination) {
+    return new Promise((resolve) => {
+        if (destination.destroyed === true) {
+            resolve();
+            return;
+        }
+        let settled = false;
+        const done = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(guard);
+            resolve();
+        };
+        const guard = setTimeout(done, 1000);
+        guard.unref();
+        try {
+            destination.once?.("close", done);
+            destination.end?.();
+        }
+        catch {
+            done();
+        }
+    });
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+const defaultSink = (level, message) => {
+    if (level === "warn")
+        console.warn(message);
+    else if (level === "error" || level === "fatal")
+        console.error(message);
+    else if (level === "trace" || level === "debug")
+        console.log(message);
+    else
+        console.info(message);
+};
+/** Mutable state shared by a root logger and all of its `child()` views. */
+class LoggerCore {
+    pluginId;
+    dir;
+    registrationId;
+    levelName;
+    formatName;
+    consoleLevel;
+    sink;
+    retentionDays;
+    redact;
+    clock;
+    fileEnabled;
+    closed = false;
+    destination;
+    destinationDay = "";
+    root;
+    children = new Map();
+    retention;
+    constructor(options) {
+        if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(options.pluginId)) {
+            throw new TypeError(`pluginId must match [A-Za-z0-9][A-Za-z0-9._-]*, got ${JSON.stringify(options.pluginId)}`);
+        }
+        this.pluginId = options.pluginId;
+        const home = options.dshHome ?? resolveDshHome();
+        this.dir = options.dir ?? join(home, "logs", options.pluginId);
+        this.levelName = options.level ?? envLevelOverride(options.pluginId) ?? "info";
+        this.formatName = options.format ?? "json";
+        this.consoleLevel = options.console ?? DEFAULT_CONSOLE_LEVEL;
+        this.sink = options.consoleSink ?? defaultSink;
+        this.retentionDays = Math.max(0, Math.floor(options.retentionDays ?? DEFAULT_LOG_RETENTION_DAYS));
+        this.redact = options.redact ?? [];
+        this.clock = options.now ?? Date.now;
+        this.fileEnabled = (options.file ?? true) && !envFileDisabled(options.dir !== undefined);
+    }
+    isClosed() {
+        return this.closed;
+    }
+    activate() {
+        if (this.closed || this.registrationId !== undefined)
+            return;
+        const state = registryState();
+        this.registrationId = state.nextRegistrationId;
+        state.nextRegistrationId += 1;
+        state.active.set(this.registrationId, this);
+        notifyRegistryListeners();
+    }
+    key() {
+        return `${this.pluginId}\u0000${this.dir}`;
+    }
+    get level() {
+        return this.levelName;
+    }
+    setLevel(level) {
+        if (!isPluginLogLevel(level)) {
+            throw new TypeError(`unknown plugin log level: ${JSON.stringify(level)}`);
+        }
+        if (level === this.levelName)
+            return;
+        this.levelName = level;
+        // Rebuild the destination on the next write so the new threshold takes
+        // effect without touching the file handle while silent.
+        this.destinationDay = "";
+        if (this.registrationId !== undefined)
+            notifyRegistryListeners();
+    }
+    get format() {
+        return this.formatName;
+    }
+    setFormat(format) {
+        if (!isPluginLogFormat(format)) {
+            throw new TypeError(`unknown plugin log format: ${JSON.stringify(format)}`);
+        }
+        if (format === this.formatName)
+            return;
+        this.formatName = format;
+        this.destinationDay = "";
+        if (this.registrationId !== undefined)
+            notifyRegistryListeners();
+    }
+    write(moduleField, level, event, fields) {
+        if (this.closed || this.levelName === "silent")
+            return;
+        if (weightOf(level) < weightOf(this.levelName)) {
+            this.mirror(moduleField, level, event, fields);
+            return;
+        }
+        this.open();
+        const target = this.targetFor(moduleField);
+        if (target !== undefined) {
+            try {
+                target[level](fields ?? {}, event);
+            }
+            catch {
+                // Fail-open: serialization problems must never break the plugin.
+            }
+        }
+        this.mirror(moduleField, level, event, fields);
+    }
+    flush() {
+        try {
+            this.destination?.flushSync?.();
+        }
+        catch {
+            // Fail-open.
+        }
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const state = registryState();
+        const cached = state.cache.get(this.key());
+        if (cached?.core === this)
+            state.cache.delete(this.key());
+        if (this.registrationId !== undefined) {
+            state.active.delete(this.registrationId);
+            this.registrationId = undefined;
+            notifyRegistryListeners();
+        }
+        const destination = this.destination;
+        this.destination = undefined;
+        this.root = undefined;
+        this.children.clear();
+        this.destinationDay = "";
+        await this.retention;
+        if (destination !== undefined)
+            await closeDestination(destination);
+    }
+    /** Open (or roll over to) the destination file for the current day. */
+    open() {
+        const stamp = dayStamp(this.clock());
+        if (this.root !== undefined && stamp === this.destinationDay)
+            return;
+        this.rollover(stamp);
+    }
+    rollover(stamp) {
+        this.destinationDay = stamp;
+        let next;
+        if (this.fileEnabled) {
+            try {
+                mkdirSync(this.dir, { recursive: true });
+                const fileDestination = pino.destination({
+                    dest: join(this.dir, `${stamp}.log`),
+                    append: true,
+                    mkdir: true,
+                    sync: false,
+                    minLength: 0,
+                });
+                next = this.formatName === "text"
+                    ? new TextDestination(fileDestination)
+                    : fileDestination;
+            }
+            catch (error) {
+                // Fail-open: an unusable log directory degrades to console-only.
+                this.fileEnabled = false;
+                next = undefined;
+                this.mirror(undefined, "warn", "logging.file_disabled", { reason: errorMessage(error) });
+            }
+        }
+        const previous = this.destination;
+        this.destination = next;
+        this.children.clear();
+        this.root = pino({
+            level: this.levelName,
+            base: { plugin: this.pluginId },
+            ...(this.redact.length > 0 ? { redact: [...this.redact] } : {}),
+        }, next ?? devNull());
+        if (previous !== undefined && previous !== next)
+            closeQuietly(previous);
+        if (this.fileEnabled)
+            this.scheduleRetentionSweep();
+    }
+    targetFor(moduleField) {
+        const root = this.root;
+        if (root === undefined)
+            return undefined;
+        if (moduleField === undefined)
+            return root;
+        const cached = this.children.get(moduleField);
+        if (cached !== undefined)
+            return cached;
+        const created = root.child({ module: moduleField });
+        this.children.set(moduleField, created);
+        return created;
+    }
+    mirror(moduleField, level, event, fields) {
+        if (this.consoleLevel === "silent")
+            return;
+        if (weightOf(level) < weightOf(this.consoleLevel))
+            return;
+        const scope = moduleField === undefined ? "" : `/${moduleField}`;
+        try {
+            this.sink(level, `[${this.pluginId}${scope}] ${formatConsole(event, fields)}`);
+        }
+        catch {
+            // Fail-open.
+        }
+    }
+    scheduleRetentionSweep() {
+        if (this.retentionDays <= 0 || this.retention !== undefined)
+            return;
+        this.retention = sweepOldLogFiles(this.dir, this.retentionDays, this.clock()).then(() => undefined, () => undefined);
+    }
+}
+class PluginLoggerImpl {
+    core;
+    moduleField;
+    constructor(core, moduleField) {
+        this.core = core;
+        this.moduleField = moduleField;
+    }
+    trace(event, fields) {
+        this.core.write(this.moduleField, "trace", event, fields);
+    }
+    debug(event, fields) {
+        this.core.write(this.moduleField, "debug", event, fields);
+    }
+    info(event, fields) {
+        this.core.write(this.moduleField, "info", event, fields);
+    }
+    warn(event, fields) {
+        this.core.write(this.moduleField, "warn", event, fields);
+    }
+    error(event, fields) {
+        this.core.write(this.moduleField, "error", event, fields);
+    }
+    fatal(event, fields) {
+        this.core.write(this.moduleField, "fatal", event, fields);
+    }
+    child(module) {
+        return new PluginLoggerImpl(this.core, module);
+    }
+    get level() {
+        return this.core.level;
+    }
+    setLevel(level) {
+        this.core.setLevel(level);
+    }
+    get format() {
+        return this.core.format;
+    }
+    setFormat(format) {
+        this.core.setFormat(format);
+    }
+    flush() {
+        this.core.flush();
+    }
+    close() {
+        return this.core.close();
+    }
+}
+/** Create a standalone logger instance (no caching). */
+export function createPluginLogger(options) {
+    const core = new LoggerCore(options);
+    const root = new PluginLoggerImpl(core);
+    core.activate();
+    return root;
+}
+/**
+ * Create or return the cached logger for `pluginId` + resolved `dir`. A later
+ * call with an explicit `level` updates the cached instance's threshold, so
+ * plugin config reloads take effect. `close()` evicts the cache entry; the
+ * next call creates a fresh instance.
+ */
+export function getPluginLogger(options) {
+    const candidate = new LoggerCore(options);
+    const key = candidate.key();
+    const state = registryState();
+    const existing = state.cache.get(key);
+    if (existing === undefined || existing.core.isClosed()) {
+        const entry = { core: candidate, root: new PluginLoggerImpl(candidate) };
+        state.cache.set(key, entry);
+        candidate.activate();
+        return entry.root;
+    }
+    if (options.level !== undefined)
+        existing.core.setLevel(options.level);
+    if (options.format !== undefined)
+        existing.core.setFormat(options.format);
+    return existing.root;
+}
+//# sourceMappingURL=plugin-logger.js.map

package/lib/plugin-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-logger.js","sourceRoot":"","sources":["../src/plugin-logger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@yadsh/dsh-plugin-log",
+  "version": "0.1.0",
+  "description": "Shared structured file logging and runtime logger discovery for DSH plugins",
+  "homepage": "https://github.com/xarleyn/dsh-plugins/tree/main/packages/plugin-log#readme",
+  "bugs": {
+    "url": "https://github.com/xarleyn/dsh-plugins/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xarleyn/dsh-plugins.git",
+    "directory": "packages/plugin-log"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src tests",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepack": "pnpm run build",
+    "check": "pnpm run lint && pnpm run typecheck && pnpm run test && pnpm run build"
+  },
+  "dependencies": {
+    "pino": "^10.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:tooling",
+    "@yadsh/dsh-config": "workspace:^",
+    "eslint": "catalog:tooling",
+    "typescript": "catalog:tooling",
+    "vitest": "catalog:tooling"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}