.opencode/gsd-core/bin/lib/observability/redaction.cjs

"use strict";
/**
 * Arg redaction policy — issue #177 (ADR-457 build-at-publish: the
 * hand-written bin/lib/observability/redaction.cjs collapsed to a TypeScript
 * source of truth). Behaviour is preserved byte-for-behaviour from the prior
 * hand-written .cjs; only types are added.
 *
 * Privacy default: args are OMITTED from every emitted event (both stderr
 * and file audit). Opt-in: set GSD_AUDIT_ARGS=1 to include args verbatim.
 *
 * This module is deliberately simple and has no side effects — redaction
 * decisions are stateless reads of process.env at call time so that tests
 * can toggle the env var without module-level caching issues.
 */
Object.defineProperty(exports, "__esModule", { value: true });
exports.shouldIncludeArgs = shouldIncludeArgs;
exports.redactEvent = redactEvent;
/**
 * Returns true when the caller has opted in to including args in events.
 * Only GSD_AUDIT_ARGS === '1' enables inclusion; any other value (including
 * empty string, 'true', 'yes') keeps the default of omitting args.
 */
function shouldIncludeArgs() {
    return process.env.GSD_AUDIT_ARGS === '1';
}
/**
 * Return a redacted copy of a DispatchEvent.
 *
 * If args should be omitted (default), strips the `args` field entirely.
 * If args should be included (GSD_AUDIT_ARGS=1), passes the event through
 * unchanged (args were already set by makeDispatchEvent with includeArgs:true,
 * or absent — in which case they stay absent).
 *
 * The original event object is never mutated (it is frozen by makeDispatchEvent).
 *
 * @param event - A DispatchEvent (frozen or plain).
 * @returns A new plain object with the same fields, minus args when redacted.
 */
function redactEvent(event) {
    if (shouldIncludeArgs()) {
        // Include path: return a shallow copy with args preserved if present
        const copy = Object.assign({}, event);
        return copy;
    }
    // Exclude path: build a copy omitting `args`
    const { args: _dropped, ...rest } = event;
    return rest;
}