@memberjunction/server 5.40.2 → 5.42.0

package/dist/logging/StartupLogger.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Server log verbosity levels, ordered from least to most chatty.
+ *
+ * Reuses the SAME enum shape as `telemetry.level` in `config.ts` so operators
+ * have a single knob (`telemetry.level` in mj.config.cjs) that governs both
+ * telemetry verbosity and server-log verbosity — there is no parallel setting.
+ *
+ * Ordering (ascending): `minimal` < `standard` < `verbose` < `debug`.
+ */
+export type ServerLogLevel = 'minimal' | 'standard' | 'verbose' | 'debug';
+/**
+ * MJServer-local startup + per-request log gating helper.
+ *
+ * Holds the resolved {@link ServerLogLevel} (from `telemetry.level`) and exposes
+ * a small surface for level-gated logging, startup phase-timing capture, and the
+ * compact summary block printed once at the end of boot.
+ *
+ * This is deliberately NOT a `BaseSingleton` and does NOT touch
+ * `@memberjunction/core` logging internals — it is a thin, process-local gate
+ * that wraps `console.*` / `LogStatus`. The point is the *gating*, not a new
+ * logging framework.
+ *
+ * Usage:
+ * ```ts
+ * const logger = new StartupLogger();
+ * logger.LogIf('verbose', 'Registered auth provider: azure');
+ * const t = logger.StartPhase();
+ * // ... work ...
+ * logger.EndPhase('DB Pool Connect', t);
+ * logger.PrintSummary();
+ * ```
+ */
+export declare class StartupLogger {
+    private readonly resolvedLevel;
+    private readonly phaseTimings;
+    private readonly summary;
+    /** Transient boot spinner — active only at `standard` level on a TTY (see {@link spinnerEnabled}). */
+    private spinner;
+    /** Interval that ticks the live elapsed counter on the spinner line. */
+    private bootTimer;
+    /** Wall-clock start of the boot indicator, for the live elapsed counter. */
+    private bootStartMs;
+    /** Most recent phase label, shown on the spinner line. */
+    private currentPhase?;
+    /**
+     * @param level Optional explicit level override (primarily for tests).
+     *              When omitted, the level is resolved from config.
+     */
+    constructor(level?: ServerLogLevel);
+    /**
+     * The resolved log level in effect for this logger instance.
+     */
+    get Level(): ServerLogLevel;
+    /**
+     * Resolves the active server log level from configuration.
+     *
+     * Source of truth is `telemetry.level` (the pre-existing enum), so a single
+     * operator knob governs both telemetry and server logging. Defaults to
+     * `standard` when unset or unrecognized.
+     */
+    static resolveLevelFromConfig(): ServerLogLevel;
+    /**
+     * True when the active level is at least `minLevel` (using the ascending
+     * `minimal < standard < verbose < debug` ordering).
+     */
+    IsAtLeast(minLevel: ServerLogLevel): boolean;
+    /**
+     * Logs `message` only when the active level is at least `minLevel`.
+     * Routes through MJ's `LogStatus` so the line participates in MJ's
+     * standard status-logging pipeline.
+     */
+    LogIf(minLevel: ServerLogLevel, message: string): void;
+    /**
+     * Starts a phase timer. Returns an opaque start timestamp to pass to
+     * {@link EndPhase}.
+     */
+    StartPhase(): number;
+    /**
+     * True when the transient boot spinner should animate: only at `standard`
+     * level AND when stdout is an interactive TTY. In non-TTY contexts (Docker,
+     * systemd, piped logs) a spinner emits escape codes that pollute log
+     * aggregation, and at `verbose`+ the inline phase lines would fight it — so
+     * both fall back to plain, line-oriented output.
+     */
+    private get spinnerEnabled();
+    /** Prefix for the transient boot indicator (no rocket — we haven't launched yet). */
+    private static readonly BOOT_LABEL;
+    /** Composes the boot label, plus the current phase when known (no elapsed counter). */
+    private bootText;
+    /** Repaints the spinner line with the current phase and a live elapsed counter. */
+    private refreshBootText;
+    /**
+     * Begins the transient "Bootstrapping…" indicator, replaced by the 🚀 summary
+     * block once {@link PrintSummary} runs (so the rocket appears only after launch).
+     *
+     * - `standard` + TTY: an animated, self-clearing `ora` spinner (its glyph is the
+     *   leading "working" icon; phase status is appended inline).
+     * - `verbose`/`debug`, or non-TTY at `standard`: a single plain line with an
+     *   hourglass icon (can't be cleared, but inline phase logs / the final block
+     *   carry the detail). `minimal` stays silent.
+     */
+    StartBoot(): void;
+    /**
+     * Marks the beginning of a named phase: updates the spinner status (when active)
+     * and returns a start timestamp to pass to {@link EndPhase}. Pure timing helper
+     * when the spinner is disabled — equivalent to {@link StartPhase}.
+     *
+     * @param phase Friendly label for the upcoming phase, shown after the boot label.
+     */
+    BeginPhase(phase: string): number;
+    /** Stops and clears the boot spinner + its elapsed-counter interval. Safe to call when inactive. */
+    StopBoot(): void;
+    /**
+     * Records the elapsed time for a phase since `startedAt`, buffering it for the
+     * summary. At `verbose`+ the phase is also printed immediately (matching the
+     * legacy `⏱️ [Startup] X: Yms` lines); at `standard` it is collapsed into the
+     * one-line `Startup` summary printed by {@link PrintSummary}.
+     *
+     * @returns A fresh timestamp, so callers can chain phases ergonomically.
+     */
+    EndPhase(label: string, startedAt: number): number;
+    /** Records the server package version for the summary header. */
+    SetVersion(version: string | undefined): void;
+    /** Records the resolved config-file path for the summary `Config` line. */
+    SetConfigPath(path: string | undefined): void;
+    /** Records DB platform + connection + entity count for the summary `DB` line. */
+    SetDatabaseInfo(platform: string, connection: string, entityCount: number): void;
+    /** Adds a registered auth-provider name to the summary `Auth` line. */
+    AddAuthProvider(name: string): void;
+    /** Records whether the REST API is enabled for the summary `Auth` line. */
+    SetRestEnabled(enabled: boolean): void;
+    /** Records the active scheduled-job count for the summary `Auth` line. */
+    SetScheduledJobCount(count: number): void;
+    /** Records the ready URL for the summary `Ready` line. */
+    SetReadyUrl(url: string): void;
+    /**
+     * Prints the boot summary appropriate for the active level:
+     *  - `minimal`: only the `Ready <url>` line.
+     *  - `standard`: the compact ~8-line summary block (with phases collapsed).
+     *  - `verbose`/`debug`: the same compact block (individual phase lines and
+     *    all detail lines were already printed inline during boot).
+     */
+    PrintSummary(): void;
+    /** Prints just the ready URL (minimal level). */
+    private printReadyLineOnly;
+    /** Renders and prints the multi-line compact summary block. */
+    private printSummaryBlock;
+    /** Builds the array of summary lines (header + indented detail rows). */
+    private buildSummaryLines;
+    /** `🚀 MemberJunction Server  ·  v<version>` (version omitted if unknown). */
+    private buildHeaderLine;
+    /** `   DB        <platform> · <connection> · <N> entities`. */
+    private buildDbLine;
+    /** `   Config    <path>` (omitted when no config file was resolved). */
+    private buildConfigLine;
+    /** `   Auth      <providers>          REST <on/off> · <N> scheduled jobs`. */
+    private buildAuthLine;
+    /**
+     * `   Startup   <total>s  (<phase> <x>s · … · other <z>s)`.
+     *
+     * The headline `<total>` is the TRUE wall-clock since process start — in Node,
+     * `performance.now()` is measured from `performance.timeOrigin` (≈ process
+     * start), so it captures the entire bootstrap (module import, config load,
+     * ServerBootstrap, and `serve()`), not just the timed phases. The parenthetical
+     * lists each captured phase; `other` is the unattributed remainder (import +
+     * config + any untimed setup) shown only when it's non-trivial.
+     */
+    private buildStartupLine;
+    /**
+     * Abbreviates a verbose phase label into a compact token for the collapsed
+     * summary line (e.g. "Metadata + Provider Setup" → "metadata").
+     */
+    private shortPhaseLabel;
+    /** `   Ready     <url>`. */
+    private buildReadyLine;
+}
+//# sourceMappingURL=StartupLogger.d.ts.map

package/dist/logging/StartupLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartupLogger.d.ts","sourceRoot":"","sources":["../../src/logging/StartupLogger.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAgD1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,sGAAsG;IACtG,OAAO,CAAC,OAAO,CAAoB;IACnC,wEAAwE;IACxE,OAAO,CAAC,SAAS,CAA+C;IAChE,4EAA4E;IAC5E,OAAO,CAAC,WAAW,CAAK;IACxB,0DAA0D;IAC1D,OAAO,CAAC,YAAY,CAAC,CAAS;IAE9B;;;OAGG;gBACS,KAAK,CAAC,EAAE,cAAc;IAIlC;;OAEG;IACH,IAAW,KAAK,IAAI,cAAc,CAEjC;IAED;;;;;;OAMG;WACW,sBAAsB,IAAI,cAAc;IAQtD;;;OAGG;IACI,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;IAInD;;;;OAIG;IACI,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7D;;;OAGG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;;;OAMG;IACH,OAAO,KAAK,cAAc,GAEzB;IAED,qFAAqF;IACrF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAyC;IAE3E,uFAAuF;IACvF,OAAO,CAAC,QAAQ;IAIhB,mFAAmF;IACnF,OAAO,CAAC,eAAe;IAOvB;;;;;;;;;OASG;IACI,SAAS,IAAI,IAAI;IAiBxB;;;;;;OAMG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMxC,oGAAoG;IAC7F,QAAQ,IAAI,IAAI;IAWvB;;;;;;;OAOG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAUzD,iEAAiE;IAC1D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpD,2EAA2E;IACpE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpD,iFAAiF;IAC1E,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAMvF,uEAAuE;IAChE,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1C,2EAA2E;IACpE,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI7C,0EAA0E;IACnE,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,0DAA0D;IACnD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;;;OAMG;IACI,YAAY,IAAI,IAAI;IAW3B,iDAAiD;IACjD,OAAO,CAAC,kBAAkB;IAO1B,+DAA+D;IAC/D,OAAO,CAAC,iBAAiB;IAMzB,yEAAyE;IACzE,OAAO,CAAC,iBAAiB;IAWzB,8EAA8E;IAC9E,OAAO,CAAC,eAAe;IAKvB,+DAA+D;IAC/D,OAAO,CAAC,WAAW;IAcnB,wEAAwE;IACxE,OAAO,CAAC,eAAe;IAOvB,8EAA8E;IAC9E,OAAO,CAAC,aAAa;IAerB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAuBvB,4BAA4B;IAC5B,OAAO,CAAC,cAAc;CAMvB"}

package/dist/logging/StartupLogger.js

@@ -0,0 +1,354 @@
+import { configInfo } from '../config.js';
+import { LogStatus } from '@memberjunction/core';
+import ora from 'ora';
+/** Numeric rank for each level, used for `>=` threshold comparisons. */
+const LEVEL_RANK = {
+    minimal: 0,
+    standard: 1,
+    verbose: 2,
+    debug: 3,
+};
+/**
+ * MJServer-local startup + per-request log gating helper.
+ *
+ * Holds the resolved {@link ServerLogLevel} (from `telemetry.level`) and exposes
+ * a small surface for level-gated logging, startup phase-timing capture, and the
+ * compact summary block printed once at the end of boot.
+ *
+ * This is deliberately NOT a `BaseSingleton` and does NOT touch
+ * `@memberjunction/core` logging internals — it is a thin, process-local gate
+ * that wraps `console.*` / `LogStatus`. The point is the *gating*, not a new
+ * logging framework.
+ *
+ * Usage:
+ * ```ts
+ * const logger = new StartupLogger();
+ * logger.LogIf('verbose', 'Registered auth provider: azure');
+ * const t = logger.StartPhase();
+ * // ... work ...
+ * logger.EndPhase('DB Pool Connect', t);
+ * logger.PrintSummary();
+ * ```
+ */
+export class StartupLogger {
+    /**
+     * @param level Optional explicit level override (primarily for tests).
+     *              When omitted, the level is resolved from config.
+     */
+    constructor(level) {
+        this.phaseTimings = [];
+        this.summary = { AuthProviders: [] };
+        /** Transient boot spinner — active only at `standard` level on a TTY (see {@link spinnerEnabled}). */
+        this.spinner = null;
+        /** Interval that ticks the live elapsed counter on the spinner line. */
+        this.bootTimer = null;
+        /** Wall-clock start of the boot indicator, for the live elapsed counter. */
+        this.bootStartMs = 0;
+        this.resolvedLevel = level ?? StartupLogger.resolveLevelFromConfig();
+    }
+    /**
+     * The resolved log level in effect for this logger instance.
+     */
+    get Level() {
+        return this.resolvedLevel;
+    }
+    /**
+     * Resolves the active server log level from configuration.
+     *
+     * Source of truth is `telemetry.level` (the pre-existing enum), so a single
+     * operator knob governs both telemetry and server logging. Defaults to
+     * `standard` when unset or unrecognized.
+     */
+    static resolveLevelFromConfig() {
+        const raw = configInfo.telemetry?.level;
+        if (raw === 'minimal' || raw === 'standard' || raw === 'verbose' || raw === 'debug') {
+            return raw;
+        }
+        return 'standard';
+    }
+    /**
+     * True when the active level is at least `minLevel` (using the ascending
+     * `minimal < standard < verbose < debug` ordering).
+     */
+    IsAtLeast(minLevel) {
+        return LEVEL_RANK[this.resolvedLevel] >= LEVEL_RANK[minLevel];
+    }
+    /**
+     * Logs `message` only when the active level is at least `minLevel`.
+     * Routes through MJ's `LogStatus` so the line participates in MJ's
+     * standard status-logging pipeline.
+     */
+    LogIf(minLevel, message) {
+        if (this.IsAtLeast(minLevel)) {
+            LogStatus(message);
+        }
+    }
+    /**
+     * Starts a phase timer. Returns an opaque start timestamp to pass to
+     * {@link EndPhase}.
+     */
+    StartPhase() {
+        return performance.now();
+    }
+    /**
+     * True when the transient boot spinner should animate: only at `standard`
+     * level AND when stdout is an interactive TTY. In non-TTY contexts (Docker,
+     * systemd, piped logs) a spinner emits escape codes that pollute log
+     * aggregation, and at `verbose`+ the inline phase lines would fight it — so
+     * both fall back to plain, line-oriented output.
+     */
+    get spinnerEnabled() {
+        return this.resolvedLevel === 'standard' && process.stdout.isTTY === true;
+    }
+    /** Prefix for the transient boot indicator (no rocket — we haven't launched yet). */
+    static { this.BOOT_LABEL = 'Bootstrapping MemberJunction Server'; }
+    /** Composes the boot label, plus the current phase when known (no elapsed counter). */
+    bootText(phase) {
+        return phase ? `${StartupLogger.BOOT_LABEL} · ${phase}` : StartupLogger.BOOT_LABEL;
+    }
+    /** Repaints the spinner line with the current phase and a live elapsed counter. */
+    refreshBootText() {
+        if (this.spinner) {
+            const elapsed = ((performance.now() - this.bootStartMs) / 1000).toFixed(1);
+            this.spinner.text = `${this.bootText(this.currentPhase)}  ${elapsed}s`;
+        }
+    }
+    /**
+     * Begins the transient "Bootstrapping…" indicator, replaced by the 🚀 summary
+     * block once {@link PrintSummary} runs (so the rocket appears only after launch).
+     *
+     * - `standard` + TTY: an animated, self-clearing `ora` spinner (its glyph is the
+     *   leading "working" icon; phase status is appended inline).
+     * - `verbose`/`debug`, or non-TTY at `standard`: a single plain line with an
+     *   hourglass icon (can't be cleared, but inline phase logs / the final block
+     *   carry the detail). `minimal` stays silent.
+     */
+    StartBoot() {
+        if (this.spinner) {
+            return;
+        }
+        if (this.spinnerEnabled) {
+            this.bootStartMs = performance.now();
+            this.spinner = ora({ text: this.bootText(), stream: process.stdout }).start();
+            // Tick the elapsed counter independently of ora's glyph animation. Unref'd so
+            // it never keeps the event loop alive; cleared by StopBoot before the block prints.
+            this.bootTimer = setInterval(() => this.refreshBootText(), 200);
+            this.bootTimer.unref();
+        }
+        else if (this.resolvedLevel !== 'minimal') {
+            // eslint-disable-next-line no-console
+            console.log(`⏳ ${this.bootText()}…`);
+        }
+    }
+    /**
+     * Marks the beginning of a named phase: updates the spinner status (when active)
+     * and returns a start timestamp to pass to {@link EndPhase}. Pure timing helper
+     * when the spinner is disabled — equivalent to {@link StartPhase}.
+     *
+     * @param phase Friendly label for the upcoming phase, shown after the boot label.
+     */
+    BeginPhase(phase) {
+        this.currentPhase = phase;
+        this.refreshBootText();
+        return performance.now();
+    }
+    /** Stops and clears the boot spinner + its elapsed-counter interval. Safe to call when inactive. */
+    StopBoot() {
+        if (this.bootTimer) {
+            clearInterval(this.bootTimer);
+            this.bootTimer = null;
+        }
+        if (this.spinner) {
+            this.spinner.stop();
+            this.spinner = null;
+        }
+    }
+    /**
+     * Records the elapsed time for a phase since `startedAt`, buffering it for the
+     * summary. At `verbose`+ the phase is also printed immediately (matching the
+     * legacy `⏱️ [Startup] X: Yms` lines); at `standard` it is collapsed into the
+     * one-line `Startup` summary printed by {@link PrintSummary}.
+     *
+     * @returns A fresh timestamp, so callers can chain phases ergonomically.
+     */
+    EndPhase(label, startedAt) {
+        const ms = performance.now() - startedAt;
+        this.phaseTimings.push({ Label: label, Ms: ms });
+        if (this.IsAtLeast('verbose')) {
+            // eslint-disable-next-line no-console
+            console.log(`⏱️  [Startup] ${label}: ${ms.toFixed(0)}ms`);
+        }
+        return performance.now();
+    }
+    /** Records the server package version for the summary header. */
+    SetVersion(version) {
+        this.summary.Version = version;
+    }
+    /** Records the resolved config-file path for the summary `Config` line. */
+    SetConfigPath(path) {
+        this.summary.ConfigPath = path;
+    }
+    /** Records DB platform + connection + entity count for the summary `DB` line. */
+    SetDatabaseInfo(platform, connection, entityCount) {
+        this.summary.DbPlatform = platform;
+        this.summary.DbConnection = connection;
+        this.summary.EntityCount = entityCount;
+    }
+    /** Adds a registered auth-provider name to the summary `Auth` line. */
+    AddAuthProvider(name) {
+        this.summary.AuthProviders.push(name);
+    }
+    /** Records whether the REST API is enabled for the summary `Auth` line. */
+    SetRestEnabled(enabled) {
+        this.summary.RestEnabled = enabled;
+    }
+    /** Records the active scheduled-job count for the summary `Auth` line. */
+    SetScheduledJobCount(count) {
+        this.summary.ScheduledJobCount = count;
+    }
+    /** Records the ready URL for the summary `Ready` line. */
+    SetReadyUrl(url) {
+        this.summary.ReadyUrl = url;
+    }
+    /**
+     * Prints the boot summary appropriate for the active level:
+     *  - `minimal`: only the `Ready <url>` line.
+     *  - `standard`: the compact ~8-line summary block (with phases collapsed).
+     *  - `verbose`/`debug`: the same compact block (individual phase lines and
+     *    all detail lines were already printed inline during boot).
+     */
+    PrintSummary() {
+        // Clear the transient spinner before any block output so the line it
+        // occupied is replaced cleanly by the summary.
+        this.StopBoot();
+        if (this.resolvedLevel === 'minimal') {
+            this.printReadyLineOnly();
+            return;
+        }
+        this.printSummaryBlock();
+    }
+    /** Prints just the ready URL (minimal level). */
+    printReadyLineOnly() {
+        if (this.summary.ReadyUrl) {
+            // eslint-disable-next-line no-console
+            console.log(`🚀 Ready  ${this.summary.ReadyUrl}`);
+        }
+    }
+    /** Renders and prints the multi-line compact summary block. */
+    printSummaryBlock() {
+        const lines = this.buildSummaryLines();
+        // eslint-disable-next-line no-console
+        console.log('\n' + lines.join('\n') + '\n');
+    }
+    /** Builds the array of summary lines (header + indented detail rows). */
+    buildSummaryLines() {
+        const lines = [];
+        lines.push(this.buildHeaderLine());
+        lines.push(this.buildDbLine());
+        lines.push(this.buildConfigLine());
+        lines.push(this.buildAuthLine());
+        lines.push(this.buildStartupLine());
+        lines.push(this.buildReadyLine());
+        return lines.filter((l) => l.length > 0);
+    }
+    /** `🚀 MemberJunction Server  ·  v<version>` (version omitted if unknown). */
+    buildHeaderLine() {
+        const version = this.summary.Version ? `  ·  v${this.summary.Version}` : '';
+        return `🚀 MemberJunction Server${version}`;
+    }
+    /** `   DB        <platform> · <connection> · <N> entities`. */
+    buildDbLine() {
+        if (!this.summary.DbPlatform) {
+            return '';
+        }
+        const parts = [this.summary.DbPlatform];
+        if (this.summary.DbConnection) {
+            parts.push(this.summary.DbConnection);
+        }
+        if (this.summary.EntityCount != null) {
+            parts.push(`${this.summary.EntityCount} entities`);
+        }
+        return `   DB        ${parts.join(' · ')}`;
+    }
+    /** `   Config    <path>` (omitted when no config file was resolved). */
+    buildConfigLine() {
+        if (!this.summary.ConfigPath) {
+            return '';
+        }
+        return `   Config    ${this.summary.ConfigPath}`;
+    }
+    /** `   Auth      <providers>          REST <on/off> · <N> scheduled jobs`. */
+    buildAuthLine() {
+        const providers = this.summary.AuthProviders.length > 0
+            ? this.summary.AuthProviders.join(', ')
+            : 'none';
+        const rest = this.summary.RestEnabled == null
+            ? ''
+            : `REST ${this.summary.RestEnabled ? 'on' : 'off'}`;
+        const jobs = this.summary.ScheduledJobCount == null
+            ? ''
+            : `${this.summary.ScheduledJobCount} scheduled jobs`;
+        const trailer = [rest, jobs].filter((s) => s.length > 0).join(' · ');
+        const trailerPart = trailer ? `   ${trailer}` : '';
+        return `   Auth      ${providers}${trailerPart}`;
+    }
+    /**
+     * `   Startup   <total>s  (<phase> <x>s · … · other <z>s)`.
+     *
+     * The headline `<total>` is the TRUE wall-clock since process start — in Node,
+     * `performance.now()` is measured from `performance.timeOrigin` (≈ process
+     * start), so it captures the entire bootstrap (module import, config load,
+     * ServerBootstrap, and `serve()`), not just the timed phases. The parenthetical
+     * lists each captured phase; `other` is the unattributed remainder (import +
+     * config + any untimed setup) shown only when it's non-trivial.
+     */
+    buildStartupLine() {
+        if (this.phaseTimings.length === 0) {
+            return '';
+        }
+        const totalMs = performance.now();
+        const phaseSumMs = this.phaseTimings.reduce((sum, p) => sum + p.Ms, 0);
+        const otherMs = totalMs - phaseSumMs;
+        const parts = this.phaseTimings.map((p) => `${this.shortPhaseLabel(p.Label)} ${(p.Ms / 1000).toFixed(1)}s`);
+        // Surface unattributed boot time only when it's meaningful (>50ms), so the
+        // line stays clean when phases already account for ~all of startup.
+        if (otherMs > 50) {
+            parts.push(`other ${(otherMs / 1000).toFixed(1)}s`);
+        }
+        return `   Startup   ${(totalMs / 1000).toFixed(1)}s  (${parts.join(' · ')})`;
+    }
+    /**
+     * Abbreviates a verbose phase label into a compact token for the collapsed
+     * summary line (e.g. "Metadata + Provider Setup" → "metadata").
+     */
+    shortPhaseLabel(label) {
+        const lower = label.toLowerCase();
+        if (lower.includes('metadata') || lower.includes('provider')) {
+            return 'metadata';
+        }
+        if (lower.includes('schema')) {
+            return 'schema';
+        }
+        if (lower.includes('db') || lower.includes('pool')) {
+            return 'db';
+        }
+        if (lower.includes('resolver') || lower.includes('middleware')) {
+            return 'resolvers';
+        }
+        if (lower.includes('apollo') || lower.includes('express')) {
+            return 'http';
+        }
+        if (lower.includes('telemetry') || lower.includes('cache')) {
+            return 'cache';
+        }
+        return lower.split(' ')[0];
+    }
+    /** `   Ready     <url>`. */
+    buildReadyLine() {
+        if (!this.summary.ReadyUrl) {
+            return '';
+        }
+        return `   Ready     ${this.summary.ReadyUrl}`;
+    }
+}
+//# sourceMappingURL=StartupLogger.js.map

package/dist/logging/StartupLogger.js.map

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

package/dist/logging/variablesLoggingMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"variablesLoggingMiddleware.d.ts","sourceRoot":"","sources":["../../src/logging/variablesLoggingMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA2E9C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B,EAAE,YAAY,CAAC,UAAU,CAsE/D,CAAC"}
+{"version":3,"file":"variablesLoggingMiddleware.d.ts","sourceRoot":"","sources":["../../src/logging/variablesLoggingMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA2F9C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B,EAAE,YAAY,CAAC,UAAU,CA0E/D,CAAC"}

package/dist/logging/variablesLoggingMiddleware.js

@@ -3,6 +3,21 @@ import { getNamedType } from 'graphql';
 import { configInfo } from '../config.js';
 import { redactArg } from './secretRedactor.js';
 import { hasNoLogParameter, getNoLogFields } from './NoLog.js';
+import { StartupLogger } from './StartupLogger.js';
+/**
+ * Memoized "is the server log level `debug`?" check. The per-resolver
+ * variables echo is gated behind BOTH `logVariables` (opt-in redaction path)
+ * AND `level === 'debug'` — it is a raw, constantly-on debug line, so it should
+ * never fire unless an operator explicitly opted into debug verbosity. Config
+ * is immutable post-boot, so caching the resolution is safe.
+ */
+let isDebugLevelCache;
+function isDebugLogLevel() {
+    if (isDebugLevelCache === undefined) {
+        isDebugLevelCache = StartupLogger.resolveLevelFromConfig() === 'debug';
+    }
+    return isDebugLevelCache;
+}
 let resolverLookup;
 function getResolverLookup() {
     if (resolverLookup !== undefined) {
@@ -94,8 +109,12 @@ export const variablesLoggingMiddleware = async (action, next) => {
             hasUndecoratedCustomArg = true;
         }
     }
-    // eslint-disable-next-line no-console
-    console.dir({ operation: action.info.fieldName, args: redactedArgs }, { depth: null, breakLength: 200 });
+    // Raw per-resolver variables echo — gated to debug-only so it never streams
+    // constantly even when an operator turns on logVariables at a lower level.
+    if (isDebugLogLevel()) {
+        // eslint-disable-next-line no-console
+        console.dir({ operation: action.info.fieldName, args: redactedArgs }, { depth: null, breakLength: 200 });
+    }
     if (hasUndecoratedCustomArg && resolverEntry) {
         const signature = `${resolverEntry.target.name}.${resolverEntry.methodName}`;
         if (!warnedResolverSignatures.has(signature)) {

package/dist/logging/variablesLoggingMiddleware.js.map

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

package/dist/resolvers/AgentSessionResolver.d.ts

@@ -0,0 +1,42 @@
+import { AppContext } from '../types.js';
+import { ResolverBase } from '../generic/ResolverBase.js';
+/** Result of {@link AgentSessionResolver.StartAgentSession}. */
+export declare class StartAgentSessionResult {
+    /** ID of the newly created session. */
+    agentSessionId: string;
+    /** Lifecycle status of the session (always `Active` on a successful start). */
+    status: string;
+    /** ID of the conversation the session is attached to (supplied or freshly created). */
+    conversationId: string;
+}
+/**
+ * Resolver for the AI Agent Session record lifecycle. A single {@link SessionManager} instance is
+ * shared across requests — it holds no per-user/provider state (only heartbeat-coalescing
+ * timestamps), and every method is passed the request `contextUser` + provider explicitly.
+ */
+export declare class AgentSessionResolver extends ResolverBase {
+    private readonly sessionManager;
+    /**
+     * Open a new session for an agent. Authorization (`CanRun`) is enforced inside
+     * {@link SessionManager.CreateSession}; a denial surfaces as a thrown error and no row is written.
+     */
+    StartAgentSession(agentId: string, { userPayload, providers }: AppContext, conversationId?: string, lastSessionId?: string, configJson?: string): Promise<StartAgentSessionResult>;
+    /**
+     * Close a session. Rejects unless the caller owns it. Returns `true` on a successful (or
+     * idempotent) close, `false` if the session can't be loaded.
+     */
+    CloseAgentSession(agentSessionId: string, { userPayload, providers }: AppContext): Promise<boolean>;
+    /**
+     * Record activity on a session (coalesced). Rejects unless the caller owns it. Returns `true`
+     * when the heartbeat was accepted (written or coalesced), `false` if the session is gone/closed.
+     */
+    AgentSessionHeartbeat(agentSessionId: string, { userPayload, providers }: AppContext): Promise<boolean>;
+    /** Resolve the request user + read-write provider, throwing a clear error if unauthenticated. */
+    private requireUserAndProvider;
+    /**
+     * Inbound ownership gate (the one genuinely new session-authz primitive): the session's `UserID`
+     * must equal the caller's. Throws on mismatch or when the session can't be loaded.
+     */
+    private assertOwnership;
+}
+//# sourceMappingURL=AgentSessionResolver.d.ts.map