@elisra-devops/docgen-data-provider 1.140.0 → 1.142.0

package/bin/tests/utils/logger.test.js

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const winston = require("winston");
+const Transport = require("winston-transport");
+const logger_1 = require("../../utils/logger");
+const logSink_1 = require("../../utils/logSink");
+const runContext_1 = require("../../utils/runContext");
+const applyRedact = (info) => (0, logger_1.redact)().transform(Object.assign({}, info));
+describe('logger redact format', () => {
+    test('scrubs a top-level token/password/secret regardless of key casing', () => {
+        const out = applyRedact({ level: 'info', message: 'x', token: 'abc', Password: 'p', SECRET: 's' });
+        expect(out.token).toBe('[REDACTED]');
+        expect(out.Password).toBe('[REDACTED]');
+        expect(out.SECRET).toBe('[REDACTED]');
+    });
+    test('scrubs nested config.auth.password and config.headers.Authorization — the AxiosError.toJSON() leak', () => {
+        // This is the exact shape that was leaking via logger.error(JSON.stringify(error))
+        // in TicketsDataProvider.ts on ADO batch work-item failures.
+        const axiosLikeError = {
+            message: 'Request failed',
+            config: {
+                auth: { username: '', password: 'super-secret-pat' },
+                headers: { Authorization: 'Bearer abc.def.ghi' },
+            },
+        };
+        const out = applyRedact({ level: 'error', message: 'error populating workitems array', err: axiosLikeError });
+        expect(out.err.config.auth.password).toBe('[REDACTED]');
+        expect(out.err.config.headers.Authorization).toBe('[REDACTED]');
+        expect(out.err.message).toBe('Request failed');
+    });
+    test('leaves non-sensitive fields untouched', () => {
+        const out = applyRedact({ level: 'info', message: 'ok', project: 'Cube-ADCS', docType: 'SVD' });
+        expect(out.project).toBe('Cube-ADCS');
+        expect(out.docType).toBe('SVD');
+    });
+    test('never throws on a circular object', () => {
+        const circular = { name: 'x' };
+        circular.self = circular;
+        expect(() => applyRedact({ level: 'info', message: 'x', circular })).not.toThrow();
+    });
+    test('never throws and passes info through on null/undefined meta', () => {
+        expect(() => applyRedact({ level: 'info', message: 'x', meta: null })).not.toThrow();
+        expect(() => applyRedact({ level: 'info', message: 'x', meta: undefined })).not.toThrow();
+    });
+});
+// A capturing transport + the exact JSON format chain logger.ts uses (errors -> timestamp ->
+// redact -> splat -> json), so these tests exercise the real pipeline, not just redact() alone.
+class CaptureTransport extends Transport {
+    constructor() {
+        super(...arguments);
+        this.lines = [];
+    }
+    log(info, callback) {
+        var _a;
+        this.lines.push(JSON.parse((_a = info[Symbol.for('message')]) !== null && _a !== void 0 ? _a : JSON.stringify(info)));
+        callback();
+    }
+}
+function makeTestLogger() {
+    const capture = new CaptureTransport();
+    const logger = winston.createLogger({
+        level: 'silly',
+        format: winston.format.combine(winston.format.errors({ stack: true }), winston.format.timestamp(), (0, logger_1.redact)(), winston.format.splat(), winston.format.json()),
+        transports: [capture],
+    });
+    return { logger, capture };
+}
+describe('logger pipeline — errors({stack:true})', () => {
+    test('logger.error(err) (single-arg Error) still produces a non-empty message and a stack', () => {
+        // This is the regression errors({stack:true}) exists to prevent: without it, winston's
+        // single-arg path makes `info` *be* the Error, and message/stack are non-enumerable, so
+        // json() would emit {"level":"error","timestamp":"…"} — content-free.
+        const { logger, capture } = makeTestLogger();
+        logger.error(new Error('boom'));
+        expect(capture.lines).toHaveLength(1);
+        expect(capture.lines[0].message).toBe('boom');
+        expect(typeof capture.lines[0].stack).toBe('string');
+        expect(capture.lines[0].stack.length).toBeGreaterThan(0);
+    });
+});
+describe('logger pipeline — hostile inputs never throw', () => {
+    test.each([
+        ['null', null],
+        ['undefined', undefined],
+        ['NaN', NaN],
+        ['a circular object', (() => { const c = { a: 1 }; c.self = c; return c; })()],
+        ['an object with a throwing getter', { get boom() { throw new Error('nope'); } }],
+        ['a BigInt', BigInt(9007199254740993)],
+        ['a Symbol', Symbol('x')],
+        ['an Error with no message', new Error()],
+        ['a 10MB string', 'x'.repeat(10 * 1024 * 1024)],
+    ])('logger.error(%s) does not throw', (_label, value) => {
+        const { logger } = makeTestLogger();
+        expect(() => logger.error(value)).not.toThrow();
+    });
+});
+describe('DiagnosticsTransport (Phase 6a)', () => {
+    function makeDiagnosticsLogger() {
+        const capture = new CaptureTransport();
+        const logger = winston.createLogger({
+            level: 'silly',
+            format: winston.format.combine(winston.format.errors({ stack: true }), winston.format.timestamp(), (0, logger_1.redact)(), winston.format.splat(), winston.format.json()),
+            transports: [capture, new logger_1.DiagnosticsTransport()],
+        });
+        return { logger, capture };
+    }
+    test('pushes warn/error records to whatever sink is installed', () => {
+        var _a, _b;
+        const events = [];
+        const sink = { push: (e) => events.push(e) };
+        (0, logSink_1.installLogSink)(sink);
+        const { logger } = makeDiagnosticsLogger();
+        logger.warn('a stable warning');
+        logger.error('a stable error', Object.assign(new Error('boom'), { code: 'ECONN' }));
+        expect(events).toHaveLength(2);
+        expect(events[0].level).toBe('warn');
+        expect((_a = events[1].err) === null || _a === void 0 ? void 0 : _a.code).toBe('ECONN');
+        expect((_b = events[1].err) === null || _b === void 0 ? void 0 : _b.stack).toEqual(expect.any(String));
+    });
+    test('does not push info/debug records', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const { logger } = makeDiagnosticsLogger();
+        logger.info('not interesting to the dashboard');
+        expect(events).toHaveLength(0);
+    });
+    test('a throwing sink cannot break the log call', () => {
+        (0, logSink_1.installLogSink)({
+            push: () => {
+                throw new Error('sink is down');
+            },
+        });
+        const { logger } = makeDiagnosticsLogger();
+        expect(() => logger.error('still must not throw')).not.toThrow();
+    });
+    test.each([
+        ['null', null],
+        ['undefined', undefined],
+        ['NaN', NaN],
+        ['a circular object', (() => { const c = { a: 1 }; c.self = c; return c; })()],
+        ['an object with a throwing getter', { get boom() { throw new Error('nope'); } }],
+        ['a BigInt', BigInt(9007199254740993)],
+        ['a Symbol', Symbol('x')],
+        ['an Error with no message', new Error()],
+        ['a 10MB string', 'x'.repeat(10 * 1024 * 1024)],
+    ])('logger.error(%s) with a sink installed does not throw', (_label, value) => {
+        (0, logSink_1.installLogSink)({ push: () => undefined });
+        const { logger } = makeDiagnosticsLogger();
+        expect(() => logger.error(value)).not.toThrow();
+    });
+});
+describe('DiagnosticsTransport request context', () => {
+    function makeLogger() {
+        return winston.createLogger({
+            level: 'silly',
+            format: winston.format.combine(winston.format.errors({ stack: true }), winston.format.timestamp(), (0, logger_1.redact)(), winston.format.splat(), winston.format.json()),
+            transports: [new logger_1.DiagnosticsTransport()],
+        });
+    }
+    test('persists an annotated error\'s request as event.context, however the call site words its message', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const err = Object.assign(new Error('Request failed with status code 404'), {
+            adoRequest: { method: 'GET', url: 'https://dev.azure.com/org/_apis/x', status: 404, attempt: 1, responseExcerpt: 'nope' },
+        });
+        makeLogger().error(err); // the bare-error shape (3 call sites) — no stable message at all
+        expect(events[0].context).toEqual({
+            method: 'GET',
+            url: 'https://dev.azure.com/org/_apis/x',
+            status: 404,
+            attempt: 1,
+            responseExcerpt: 'nope',
+        });
+    });
+    test('also works for the stable-message + error shape and for the explicit meta shape', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const logger = makeLogger();
+        const ctx = { method: 'POST', url: 'https://h/wiql', requestBody: '{"query":"q"}' };
+        logger.error('Failed querying work items', Object.assign(new Error('boom'), { adoRequest: ctx }));
+        logger.error('ADO request failed', { message: 'boom', stack: 'at x', adoRequest: ctx });
+        expect(events[0].context).toEqual(ctx);
+        expect(events[1].context).toEqual(ctx);
+    });
+    test('an event with no request context has no context field', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        makeLogger().error('plain failure', new Error('boom'));
+        expect(events[0].context).toBeUndefined();
+    });
+    test('re-validates the shape at the transport: unknown keys, wrong types and oversize values are dropped or bounded', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const err = Object.assign(new Error('x'), {
+            adoRequest: {
+                method: 'GET',
+                url: 'u'.repeat(5000),
+                status: 'not-a-number',
+                attempt: 2,
+                requestBody: 'b'.repeat(5000),
+                secretHeader: 'Bearer abc',
+            },
+        });
+        makeLogger().error('m', err);
+        const ctx = events[0].context;
+        expect(ctx.url.length).toBe(1000);
+        expect(ctx.requestBody.length).toBe(2000);
+        expect(ctx.status).toBeUndefined();
+        expect(ctx.attempt).toBe(2);
+        expect(ctx).not.toHaveProperty('secretHeader');
+    });
+});
+describe('text format request suffix', () => {
+    // The default (LOG_FORMAT unset) prints only the message — without this the URL would never
+    // reach stdout for a record whose own message doesn't carry it. A stream transport on the
+    // real logger receives the already-formatted line, independent of how jest wires console.
+    test('appends the request to the printed line when the error carries one, and never throws', () => {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const logger = require('../../utils/logger').default;
+        const { Writable } = require('stream');
+        const lines = [];
+        const sink = new winston.transports.Stream({
+            stream: new Writable({
+                write(chunk, _enc, cb) {
+                    lines.push(chunk.toString());
+                    cb();
+                },
+            }),
+        });
+        logger.add(sink);
+        try {
+            const err = Object.assign(new Error('Request failed with status code 404'), {
+                adoRequest: { method: 'GET', url: 'https://dev.azure.com/org/_apis/x', status: 404 },
+            });
+            expect(() => logger.error('Failed fetching', err)).not.toThrow();
+            expect(() => logger.error('odd', Object.assign(new Error('e'), { adoRequest: { url: 123 } }))).not.toThrow();
+        }
+        finally {
+            logger.remove(sink);
+        }
+        const joined = lines.join('');
+        expect(joined).toContain('[GET https://dev.azure.com/org/_apis/x -> 404]');
+        expect(joined).toContain('Failed fetching');
+    });
+});
+describe('textFormat safety (regression)', () => {
+    // The hostile-input matrix above exercises makeTestLogger()'s json() pipeline — it never
+    // touched the real singleton logger's text-format branch (LOG_FORMAT's default), which is
+    // where a Symbol message crashed: a template literal's implicit ToString throws on a Symbol,
+    // and this formatter sits with no try/catch around it.
+    test('logger.error(Symbol) does not throw through the real default-exported logger', () => {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const logger = require('../../utils/logger').default;
+        expect(() => logger.error(Symbol('x'))).not.toThrow();
+    });
+});
+describe('DiagnosticsTransport capture policy (Phase 6b)', () => {
+    function makeDiagnosticsLogger() {
+        const capture = new CaptureTransport();
+        const logger = winston.createLogger({
+            level: 'silly',
+            format: winston.format.combine(winston.format.errors({ stack: true }), winston.format.timestamp(), (0, logger_1.redact)(), winston.format.splat(), winston.format.json()),
+            transports: [capture, new logger_1.DiagnosticsTransport()],
+        });
+        return { logger, capture };
+    }
+    test('normal mode (no captureMode) does not persist debug/info', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const { logger } = makeDiagnosticsLogger();
+        runContext_1.runContextStore.run({ runId: 'run-1' }, () => {
+            logger.debug('a debug line');
+            logger.info('an info line');
+        });
+        expect(events).toHaveLength(0);
+    });
+    test('verbose mode persists debug and info', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const { logger } = makeDiagnosticsLogger();
+        runContext_1.runContextStore.run({ runId: 'run-2', captureMode: 'verbose' }, () => {
+            logger.debug('a debug line');
+            logger.info('an info line');
+        });
+        expect(events).toHaveLength(2);
+        expect(events[0].retainPending).toBeUndefined();
+    });
+    test('warn/error persist regardless of capture mode', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const { logger } = makeDiagnosticsLogger();
+        runContext_1.runContextStore.run({ runId: 'run-3' }, () => {
+            logger.warn('a warning');
+            logger.error('an error');
+        });
+        expect(events).toHaveLength(2);
+    });
+    test('retain-on-failure persists debug/info tagged retainPending: true', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const { logger } = makeDiagnosticsLogger();
+        runContext_1.runContextStore.run({ runId: 'run-4', captureMode: 'retain-on-failure' }, () => {
+            logger.debug('a debug line');
+        });
+        expect(events).toHaveLength(1);
+        expect(events[0].retainPending).toBe(true);
+    });
+    test('retain-on-failure does not tag warn/error as retainPending', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const { logger } = makeDiagnosticsLogger();
+        runContext_1.runContextStore.run({ runId: 'run-5', captureMode: 'retain-on-failure' }, () => {
+            logger.error('an error');
+        });
+        expect(events).toHaveLength(1);
+        expect(events[0].retainPending).toBeUndefined();
+    });
+    test('a concurrent normal-mode run is unaffected by a sibling verbose run', () => {
+        const events = [];
+        (0, logSink_1.installLogSink)({ push: (e) => events.push(e) });
+        const { logger } = makeDiagnosticsLogger();
+        runContext_1.runContextStore.run({ runId: 'verbose-run', captureMode: 'verbose' }, () => {
+            logger.debug('verbose debug');
+        });
+        runContext_1.runContextStore.run({ runId: 'normal-run' }, () => {
+            logger.debug('normal debug');
+        });
+        expect(events).toHaveLength(1);
+        expect(events[0].message).toBe('verbose debug');
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/bin/tests/utils/logger.test.js.map

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

package/bin/tests/utils/runContext.test.d.ts

@@ -0,0 +1 @@
+export {};

package/bin/tests/utils/runContext.test.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const winston = require("winston");
+const Transport = require("winston-transport");
+const logger_1 = require("../../utils/logger");
+const runContext_1 = require("../../utils/runContext");
+class CaptureTransport extends Transport {
+    constructor() {
+        super(...arguments);
+        this.lines = [];
+    }
+    log(info, callback) {
+        var _a;
+        this.lines.push(JSON.parse((_a = info[Symbol.for('message')]) !== null && _a !== void 0 ? _a : JSON.stringify(info)));
+        callback();
+    }
+}
+function makeTestLogger() {
+    const capture = new CaptureTransport();
+    const logger = winston.createLogger({
+        level: 'silly',
+        format: winston.format.combine((0, logger_1.withRunContext)(), winston.format.json()),
+        transports: [capture],
+    });
+    return { logger, capture };
+}
+describe('withRunContext', () => {
+    test('is a no-op when the store was never populated', () => {
+        const { logger, capture } = makeTestLogger();
+        logger.info('outside any run');
+        expect(capture.lines[0].runId).toBeUndefined();
+    });
+    test('stamps runId onto every log emitted inside store.run(...)', () => {
+        const { logger, capture } = makeTestLogger();
+        runContext_1.runContextStore.run({ runId: 'run-123' }, () => {
+            logger.info('inside the run');
+        });
+        logger.info('outside again');
+        expect(capture.lines[0].runId).toBe('run-123');
+        expect(capture.lines[1].runId).toBeUndefined();
+    });
+    test('async work started inside the run keeps the runId across the await boundary', async () => {
+        const { logger, capture } = makeTestLogger();
+        await runContext_1.runContextStore.run({ runId: 'run-async' }, async () => {
+            await new Promise((resolve) => setTimeout(resolve, 0));
+            logger.info('after await');
+        });
+        expect(capture.lines[0].runId).toBe('run-async');
+    });
+});
+//# sourceMappingURL=runContext.test.js.map

package/bin/tests/utils/runContext.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runContext.test.js","sourceRoot":"","sources":["../../../src/tests/utils/runContext.test.ts"],"names":[],"mappings":";;AAAA,mCAAmC;AACnC,+CAAgD;AAChD,+CAAoD;AACpD,uDAAyD;AAEzD,MAAM,gBAAiB,SAAQ,SAAS;IAAxC;;QACE,UAAK,GAA8B,EAAE,CAAC;IAKxC,CAAC;IAJC,GAAG,CAAC,IAA6B,EAAE,QAAoB;;QACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAC,IAAY,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,mCAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1F,QAAQ,EAAE,CAAC;IACb,CAAC;CACF;AACD,SAAS,cAAc;IACrB,MAAM,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;QAClC,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAA,uBAAc,GAAE,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACvE,UAAU,EAAE,CAAC,OAAO,CAAC;KACtB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC/B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACrE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;QAC7C,4BAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC7F,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;QAC7C,MAAM,4BAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/bin/utils/logSink.d.ts

@@ -0,0 +1,39 @@
+export declare const CONTEXT_LIMITS: {
+    readonly method: 10;
+    readonly url: 1000;
+    readonly requestBody: 2000;
+    readonly responseExcerpt: 300;
+};
+export interface DiagnosticEvent {
+    ts: string;
+    level: string;
+    service: string;
+    version: string;
+    runId?: string;
+    docType?: string;
+    step?: string;
+    contentControlType?: string;
+    contentControlTitle?: string;
+    project?: string;
+    userId?: string;
+    message: string;
+    err?: {
+        message: string;
+        code?: string;
+        stack?: string;
+    };
+    context?: {
+        method?: string;
+        url?: string;
+        status?: number;
+        attempt?: number;
+        requestBody?: string;
+        responseExcerpt?: string;
+    };
+    retainPending?: boolean;
+}
+export interface LogSink {
+    push(event: DiagnosticEvent): void;
+}
+export declare function getLogSink(): LogSink | undefined;
+export declare function installLogSink(sink: LogSink): void;

package/bin/utils/logSink.js

@@ -0,0 +1,28 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTEXT_LIMITS = void 0;
+exports.getLogSink = getLogSink;
+exports.installLogSink = installLogSink;
+// The one queryable-error-store event shape, emitted by DiagnosticsTransport (logger.ts).
+// This package never installs a sink itself — it only reads whatever the host process
+// (docgen-content-control's index.ts) installed. err stays narrow — {message, code, stack}.
+// `context` is the one deliberate exception to "no extra-fields bucket": a sanitized
+// description of the failed outbound request (method, url, status, attempt, request-body
+// summary, response excerpt) — without it a 404 in the dashboard can't be traced to the call
+// that produced it. A fixed, allowlisted shape, not a free-form bag.
+// Bounds for DiagnosticEvent.context. Single source for this package (requestContext.ts and the
+// logger transport); docgen-api-gate's DiagnosticsController.sanitizeContext re-validates at
+// ingest with its own copy — keep the two in step.
+exports.CONTEXT_LIMITS = { method: 10, url: 1000, requestBody: 2000, responseExcerpt: 300 };
+// Symbol.for so this package's copy converges on the same installed sink as
+// docgen-content-control's (the host process this package runs inside) and
+// docgen-dg-skins-package's, the same reasoning as runContext.ts's AsyncLocalStorage. A
+// never-populated sink is a harmless no-op — this package only reads it, never installs one.
+const KEY = Symbol.for('elisradevops.docgen.logSink');
+function getLogSink() {
+    return globalThis[KEY];
+}
+function installLogSink(sink) {
+    globalThis[KEY] = sink;
+}
+//# sourceMappingURL=logSink.js.map

package/bin/utils/logSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logSink.js","sourceRoot":"","sources":["../../src/utils/logSink.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AAoDb,gCAEC;AAED,wCAEC;AAxDD,0FAA0F;AAC1F,sFAAsF;AACtF,4FAA4F;AAC5F,qFAAqF;AACrF,yFAAyF;AACzF,6FAA6F;AAC7F,qEAAqE;AACrE,gGAAgG;AAChG,6FAA6F;AAC7F,mDAAmD;AACtC,QAAA,cAAc,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAW,CAAC;AAkC1G,4EAA4E;AAC5E,2EAA2E;AAC3E,wFAAwF;AACxF,6FAA6F;AAC7F,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAEtD,SAAgB,UAAU;IACxB,OAAQ,UAAsC,CAAC,GAAG,CAAwB,CAAC;AAC7E,CAAC;AAED,SAAgB,cAAc,CAAC,IAAa;IACzC,UAAsC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACtD,CAAC"}

package/bin/utils/logger.d.ts

@@ -1,3 +1,10 @@
 import * as winston from 'winston';
+import * as Transport from 'winston-transport';
 declare let logger: winston.Logger;
+export declare const withRunContext: winston.Logform.FormatWrap;
+export declare function redactValue(value: unknown, depth?: number, seen?: WeakSet<object>): unknown;
+export declare const redact: winston.Logform.FormatWrap;
+export declare class DiagnosticsTransport extends Transport {
+    log(info: Record<string, unknown>, callback: () => void): void;
+}
 export default logger;