smol-symphony 0.2.0 → 0.3.0

package/dist/logging.js

@@ -1,203 +0,0 @@
-// Structured key=value logging per SPEC.md §9.1.
-// Sink failures do not crash the orchestrator (§9.2).
-//
-// Persistent file sink: when `setLogFile(path)` has been called, each emitted
-// line is appended to that file. The on-disk format matches the stderr format
-// (one `key=value ...` line per event) so an agent inspecting logs later sees
-// the same shape. File-sink failures are swallowed (one stderr warning on first
-// failure, then silent) per §9.2 so a full disk or permission error can never
-// crash the orchestrator.
-//
-// Console routing (issue 118): when a file sink is active, structured lines go
-// to the file ONLY — the operator console stays clean and shows just the
-// intentional stdout banner. stderr remains the fallback when no file sink is
-// configured (nothing is silently lost in a no-log-file setup), and
-// `setLogVerbose(true)` (the `--verbose` flag) forces lines back onto stderr
-// alongside the file for interactive debugging.
-import { closeSync, createWriteStream, mkdirSync, openSync } from 'node:fs';
-import path from 'node:path';
-const ENV_LEVEL = (process.env.SYMPHONY_LOG_LEVEL ?? 'info').toLowerCase();
-const LEVEL_RANK = { debug: 10, info: 20, warn: 30, error: 40 };
-let fileSink = null;
-let fileSinkBroken = false;
-let fileSinkPath = null;
-let verbose = false;
-function quote(v) {
-    if (v === null || v === undefined)
-        return '';
-    const s = String(v);
-    return /[\s"=]/.test(s) ? JSON.stringify(s) : s;
-}
-function format(level, msg, fields) {
-    const ts = new Date().toISOString();
-    const parts = [`ts=${ts}`, `level=${level}`, `msg=${quote(msg)}`];
-    for (const [k, v] of Object.entries(fields)) {
-        if (v === undefined)
-            continue;
-        parts.push(`${k}=${quote(v)}`);
-    }
-    return parts.join(' ');
-}
-function writeFileSink(line) {
-    if (!fileSink || fileSinkBroken)
-        return;
-    try {
-        fileSink.write(line);
-    }
-    catch {
-        // Stream errors land in the 'error' handler attached in setLogFile; a
-        // synchronous throw is unusual but not impossible — swallow it.
-    }
-}
-function emit(level, msg, fields = {}) {
-    if (LEVEL_RANK[level] < LEVEL_RANK[ENV_LEVEL])
-        return;
-    const line = format(level, msg, fields) + '\n';
-    // Route to stderr only when no working file sink is capturing the line
-    // (so a no-log-file setup loses nothing) or when --verbose was requested
-    // (interactive debugging). A broken sink counts as inactive so its dropped
-    // writes fall back to stderr rather than vanishing. See issue 118.
-    const fileSinkActive = fileSink !== null && !fileSinkBroken;
-    if (verbose || !fileSinkActive) {
-        try {
-            process.stderr.write(line);
-        }
-        catch {
-            // Spec §9.2: a failed sink must not crash the service.
-        }
-    }
-    writeFileSink(line);
-}
-/**
- * Force structured logs back onto stderr even when a file sink is active. The
- * `--verbose` / `--foreground` flag flips this on for interactive debugging;
- * the default (false) keeps the console clean by routing logs to the file only
- * whenever a sink is configured. Idempotent.
- */
-export function setLogVerbose(on) {
-    verbose = on;
-}
-/**
- * Enable (or replace) the persistent file sink. Pass `null` to close any
- * currently-open file sink and revert to stderr-only.
- *
- * The directory is created on demand. The file is opened synchronously via
- * `openSync` so failures (EISDIR, EACCES, ENOTDIR, ENOSPC) raise before the
- * sink is installed — by the time this returns a non-null path, the file is
- * known to be writable. Open failures do not throw: a single stderr warning
- * is emitted and the function returns `null` so callers can branch without a
- * try/catch. After a successful open, runtime stream errors flip the sink
- * into a broken state (silently dropping further writes) so a mid-run
- * disk-full condition cannot recursively spam stderr.
- *
- * Idempotent for repeated calls with the same path. Returns the absolute path
- * actually opened, or `null` when the sink was disabled or failed to open.
- */
-export function setLogFile(filePath) {
-    if (filePath === null || filePath === '') {
-        void closeLogFile();
-        return null;
-    }
-    const abs = path.resolve(filePath);
-    if (fileSink && fileSinkPath === abs && !fileSinkBroken)
-        return abs;
-    void closeLogFile();
-    let fd;
-    try {
-        mkdirSync(path.dirname(abs), { recursive: true });
-        // Open synchronously so EISDIR / EACCES / ENOTDIR surface here instead of
-        // arriving asynchronously on the stream's 'error' event after setLogFile()
-        // has already returned the path. Passing the fd into createWriteStream
-        // tells Node to reuse it (the stream's close still releases the fd).
-        fd = openSync(abs, 'a');
-    }
-    catch (err) {
-        try {
-            process.stderr.write(format('warn', 'log file sink open failed', { path: abs, error: err.message }) +
-                '\n');
-        }
-        catch {
-            // stderr itself failed; nothing left to do.
-        }
-        fileSink = null;
-        fileSinkPath = null;
-        fileSinkBroken = false;
-        return null;
-    }
-    let stream;
-    try {
-        stream = createWriteStream(abs, { encoding: 'utf8', fd, autoClose: true });
-    }
-    catch (err) {
-        try {
-            closeSync(fd);
-        }
-        catch {
-            // fd already gone; nothing to do.
-        }
-        try {
-            process.stderr.write(format('warn', 'log file sink open failed', { path: abs, error: err.message }) +
-                '\n');
-        }
-        catch {
-            // stderr itself failed; nothing left to do.
-        }
-        fileSink = null;
-        fileSinkPath = null;
-        fileSinkBroken = false;
-        return null;
-    }
-    stream.on('error', (err) => {
-        if (!fileSinkBroken) {
-            fileSinkBroken = true;
-            try {
-                process.stderr.write(format('warn', 'log file sink write failed', { path: abs, error: err.message }) + '\n');
-            }
-            catch {
-                // stderr itself failed; nothing left to do.
-            }
-        }
-    });
-    fileSink = stream;
-    fileSinkPath = abs;
-    fileSinkBroken = false;
-    return abs;
-}
-/**
- * Close the file sink and await the underlying stream's flush. Safe to call
- * repeatedly. Callers that intend to `process.exit()` immediately afterwards
- * MUST await this — `process.exit` does not drain pending WriteStream writes,
- * so the final log lines (including the shutdown banner) would otherwise be
- * lost. Tests that read the file back also await.
- */
-export async function closeLogFile() {
-    const sink = fileSink;
-    fileSink = null;
-    fileSinkPath = null;
-    fileSinkBroken = false;
-    if (!sink)
-        return;
-    await new Promise((resolve) => {
-        try {
-            sink.end(() => resolve());
-        }
-        catch {
-            resolve();
-        }
-    });
-}
-export const log = {
-    debug: (msg, fields) => emit('debug', msg, fields ?? {}),
-    info: (msg, fields) => emit('info', msg, fields ?? {}),
-    warn: (msg, fields) => emit('warn', msg, fields ?? {}),
-    error: (msg, fields) => emit('error', msg, fields ?? {}),
-};
-export function withIssue(ctx) {
-    return {
-        debug: (msg, fields = {}) => log.debug(msg, { ...ctx, ...fields }),
-        info: (msg, fields = {}) => log.info(msg, { ...ctx, ...fields }),
-        warn: (msg, fields = {}) => log.warn(msg, { ...ctx, ...fields }),
-        error: (msg, fields = {}) => log.error(msg, { ...ctx, ...fields }),
-    };
-}
-//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

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