@senpi/runtime 3.0.6-dev.runtime-phase-2.20260630134145 → 3.0.6-dev.runtime-phase-2.20260630134327

package/dist/runtime/create-scanner-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-scanner-module.js","sourceRoot":"","sources":["../../src/runtime/create-scanner-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oCAAoC,CAClD,MAAqB,EACrB,QAAgB,EAChB,SAAgC,EAChC,MAAsB;IAEtB,MAAM,QAAQ,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvC,yEAAyE;QACzE,+EAA+E;QAC/E,8EAA8E;QAC9E,8EAA8E;QAC9E,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,KAAK,kBAAkB,CAAC;QAClD,MAAM,cAAc,GAAG,UAAU;YAC/B,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,kBAAkB,IAAI,EAAE,EAAE;YACzC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;QACd,QAAQ,CAAC,IAAI,CACX,eAAe,CAAC,aAAa,CAC3B,EAAE,CAAC,IAAI,EACP,EAAE,CAAC,IAAI,EACP,cAAc,EACd,EAAE,CAAC,UAAU,EACb,UAAU;YACR,CAAC,CAAC;gBACE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC1C,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,gBAAgB,EAAE,EAAE,CAAC,kBAAkB;aACxC;YACH,CAAC,CAAC,SAAS,CACd,CACF,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,uBAAuB,CACzC,MAAM,EACN,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EACrD,MAAM,CACP,CAAC;IACF,OAAO,0BAA0B,CAAC;QAChC,QAAQ;QACR,QAAQ;QACR,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QAC5D,WAAW;QACX,SAAS;QACT,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"create-scanner-module.js","sourceRoot":"","sources":["../../src/runtime/create-scanner-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oCAAoC,CAClD,MAAqB,EACrB,QAAgB,EAChB,SAAgC,EAChC,MAAsB,EACtB,QAAiC;IAEjC,MAAM,QAAQ,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvC,yEAAyE;QACzE,+EAA+E;QAC/E,8EAA8E;QAC9E,8EAA8E;QAC9E,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,KAAK,kBAAkB,CAAC;QAClD,MAAM,cAAc,GAAG,UAAU;YAC/B,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,kBAAkB,IAAI,EAAE,EAAE;YACzC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;QACd,QAAQ,CAAC,IAAI,CACX,eAAe,CAAC,aAAa,CAC3B,EAAE,CAAC,IAAI,EACP,EAAE,CAAC,IAAI,EACP,cAAc,EACd,EAAE,CAAC,UAAU,EACb,UAAU;YACR,CAAC,CAAC;gBACE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC1C,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,gBAAgB,EAAE,EAAE,CAAC,kBAAkB;aACxC;YACH,CAAC,CAAC,SAAS,CACd,CACF,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,uBAAuB,CACzC,MAAM,EACN,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EACrD,MAAM,CACP,CAAC;IACF,OAAO,0BAA0B,CAAC;QAChC,QAAQ;QACR,QAAQ;QACR,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QAC5D,WAAW;QACX,SAAS;QACT,MAAM;QACN,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/dist/runtime/domain-events.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The event-log half of the real domain events on the bus: `position.*` lifecycle and `dsl.*`
+ * transitions. Unlike the action-origin events (order/decision/outcome), these are first-class facts
+ * already broadcast on the `SenpiEventBus` — so one thin subscriber maps each to a `logger.event`,
+ * reusing the pure recording builders ({@link buildPositionLifecycle} / {@link buildDslTransition})
+ * for the field projection rather than re-parsing the payloads.
+ *
+ * Why a subscriber, not at-site: the bus is a synchronous `EventEmitter`, so a handler runs in the
+ * emitter's async context — it inherits the active span (trace_id/span_id auto-stamp) and the
+ * `trackingContext` identity exactly as an at-site emit would. Position events fire inside the signal
+ * flow; `dsl.*` transitions fire inside the monitor tick, which the DSL plugin wraps in a
+ * `trackingContext` so these carry identity too.
+ *
+ * All fields here are safe scalars — these events carry no free-text, so none use the `redact` slot.
+ */
+import type { SenpiEventBus } from "../types/event-bus.js";
+import type { DslTransitionKind, PositionLifecycleEvent } from "../recording/records.js";
+import { type EmittableEvent } from "../actions/event-derivation.js";
+/**
+ * Map a `position.*` lifecycle record to its event. An `opened` whose `reconciliation_source` is
+ * `externally_detected` is surfaced as `position.reconciled` — a gap-pass position the runtime did
+ * not open — so the two are distinguishable downstream; everything else maps one-to-one. All `info`.
+ */
+declare function buildPositionLifecycleEvent(event: PositionLifecycleEvent, payload: unknown, nowMs: number): EmittableEvent | null;
+/** Map a `dsl.*` transition record to its event. All `info` — failure rides `dsl.closed`'s reason. */
+declare function buildDslTransitionEvent(transition: DslTransitionKind, payload: unknown, nowMs: number): EmittableEvent | null;
+export interface DomainEventSubscriber {
+    /** Unsubscribe every handler. Idempotent. */
+    dispose(): void;
+}
+/**
+ * Subscribe the event log to the `position.*` / `dsl.*` domain events on the bus. Each handler builds
+ * its event through {@link emitEvent}'s guard, so a throwing builder or a telemetry failure can never
+ * propagate back through `bus.emit` into the trading path. Mirrors the recording subscriber's wiring;
+ * attach only when telemetry is enabled (per-event assembly on the serial path is dead work otherwise).
+ */
+export declare function createDomainEventSubscriber(bus: SenpiEventBus): DomainEventSubscriber;
+export declare const __test: {
+    buildPositionLifecycleEvent: typeof buildPositionLifecycleEvent;
+    buildDslTransitionEvent: typeof buildDslTransitionEvent;
+};
+export {};
+//# sourceMappingURL=domain-events.d.ts.map

package/dist/runtime/domain-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-events.d.ts","sourceRoot":"","sources":["../../src/runtime/domain-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK3D,OAAO,KAAK,EACV,iBAAiB,EAEjB,sBAAsB,EAEvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAkDhF;;;;GAIG;AACH,iBAAS,2BAA2B,CAClC,KAAK,EAAE,sBAAsB,EAC7B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,IAAI,CA+BvB;AAwBD,sGAAsG;AACtG,iBAAS,uBAAuB,CAC9B,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,IAAI,CA0BvB;AAED,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,aAAa,GAAG,qBAAqB,CA6BrF;AAGD,eAAO,MAAM,MAAM;;;CAA2D,CAAC"}

package/dist/runtime/domain-events.js

@@ -0,0 +1,181 @@
+/**
+ * The event-log half of the real domain events on the bus: `position.*` lifecycle and `dsl.*`
+ * transitions. Unlike the action-origin events (order/decision/outcome), these are first-class facts
+ * already broadcast on the `SenpiEventBus` — so one thin subscriber maps each to a `logger.event`,
+ * reusing the pure recording builders ({@link buildPositionLifecycle} / {@link buildDslTransition})
+ * for the field projection rather than re-parsing the payloads.
+ *
+ * Why a subscriber, not at-site: the bus is a synchronous `EventEmitter`, so a handler runs in the
+ * emitter's async context — it inherits the active span (trace_id/span_id auto-stamp) and the
+ * `trackingContext` identity exactly as an at-site emit would. Position events fire inside the signal
+ * flow; `dsl.*` transitions fire inside the monitor tick, which the DSL plugin wraps in a
+ * `trackingContext` so these carry identity too.
+ *
+ * All fields here are safe scalars — these events carry no free-text, so none use the `redact` slot.
+ */
+import { buildDslTransition, buildPositionLifecycle, } from "../recording/wiring/record-builders.js";
+import { EVENT_NAME, eventAttrs, fmtThousands } from "../utils/event-catalog.js";
+import { createLogger } from "../utils/logger.js";
+import { emitEvent } from "../actions/event-derivation.js";
+const eventLog = createLogger("[senpi-core][domain-events]");
+/** `on_position_*` bus event → the lifecycle discriminator the record builder expects. */
+const POSITION_EVENTS = {
+    on_position_opened: "opened",
+    on_position_closed: "closed",
+    on_position_flipped: "flipped",
+    on_position_increased: "increased",
+    on_position_decreased: "decreased",
+};
+/** `dsl.*` bus event → the transition discriminator. `dsl.close_attempt` stays a 9b trace unit. */
+const DSL_EVENTS = {
+    "dsl.created": "created",
+    "dsl.tier_advanced": "tier_advanced",
+    "dsl.phase_changed": "phase_changed",
+    "dsl.sl_updated": "sl_updated",
+    "dsl.close_pending": "close_pending",
+    "dsl.closed": "closed",
+    "dsl.deleted": "deleted",
+};
+const DIRECTION_TAG = (dir) => (dir ? ` ${dir}` : "");
+const SIZE_AT = (price) => (price !== undefined ? ` @ ${fmtThousands(price)}` : "");
+/** The queryable scalar surface shared by every `position.*` event (fields absent on a variant drop out). */
+function positionAttributes(rec) {
+    return eventAttrs({
+        "senpi.position.id": rec.positionId,
+        "senpi.asset": rec.asset,
+        "senpi.dex": rec.dex,
+        "senpi.position.direction": rec.direction ?? undefined,
+        "senpi.position.entry_price": rec.entryPrice,
+        "senpi.position.size": rec.size,
+        "senpi.position.leverage": rec.leverage,
+        "senpi.position.margin": rec.margin,
+        "senpi.position.unrealized_pnl": rec.unrealizedPnl,
+        "senpi.position.roe": rec.roe,
+        "senpi.position.close_reason": rec.closeReason,
+        "senpi.position.closed_price": rec.closedPrice,
+        "senpi.position.closed_size": rec.closedSize,
+        "senpi.position.size_delta": rec.sizeDelta,
+        "senpi.position.previous_size": rec.previousSize,
+        "senpi.position.new_asset": rec.newAsset,
+        "senpi.position.reconciliation_source": rec.reconciliationSource,
+    });
+}
+/**
+ * Map a `position.*` lifecycle record to its event. An `opened` whose `reconciliation_source` is
+ * `externally_detected` is surfaced as `position.reconciled` — a gap-pass position the runtime did
+ * not open — so the two are distinguishable downstream; everything else maps one-to-one. All `info`.
+ */
+function buildPositionLifecycleEvent(event, payload, nowMs) {
+    const rec = buildPositionLifecycle(event, payload, nowMs);
+    if (rec === null)
+        return null;
+    const attributes = positionAttributes(rec);
+    const head = `${rec.asset}${DIRECTION_TAG(rec.direction)}`;
+    const base = { level: "info", attributes };
+    switch (rec.event) {
+        case "opened": {
+            const sized = rec.size !== undefined ? ` ${rec.size}` : "";
+            if (rec.reconciliationSource === "externally_detected") {
+                return { name: EVENT_NAME.positionReconciled, body: `Reconciled ${head}${sized} — externally detected`, ...base };
+            }
+            return { name: EVENT_NAME.positionOpened, body: `Opened ${head}${sized}${SIZE_AT(rec.entryPrice)}`, ...base };
+        }
+        case "closed":
+            return {
+                name: EVENT_NAME.positionClosed,
+                body: `Closed ${head}${SIZE_AT(rec.closedPrice)}${rec.closeReason ? ` (${rec.closeReason})` : ""}`,
+                ...base,
+            };
+        case "increased":
+            return { name: EVENT_NAME.positionIncreased, body: `Increased ${head}${rec.sizeDelta !== undefined ? ` by ${rec.sizeDelta}` : ""}`, ...base };
+        case "decreased":
+            return { name: EVENT_NAME.positionDecreased, body: `Decreased ${head}${rec.sizeDelta !== undefined ? ` by ${rec.sizeDelta}` : ""}`, ...base };
+        case "flipped":
+            return { name: EVENT_NAME.positionFlipped, body: `Flipped ${head}${rec.newAsset ? ` → ${rec.newAsset}` : ""}`, ...base };
+        default:
+            // `open_order_submitted` is not an event-log event (not subscribed); ignore defensively.
+            return null;
+    }
+}
+/** The queryable scalar surface shared by every `dsl.*` transition (fields absent on a variant drop out). */
+function dslAttributes(rec) {
+    return eventAttrs({
+        "senpi.position.id": rec.positionId,
+        "senpi.asset": rec.asset,
+        "senpi.dex": rec.dex,
+        "senpi.position.direction": rec.direction ?? undefined,
+        "senpi.dsl.preset": rec.preset,
+        "senpi.dsl.phase": rec.phase,
+        "senpi.dsl.tier_index": rec.tierIndex ?? undefined,
+        "senpi.dsl.floor_price": rec.floorPrice,
+        "senpi.dsl.new_floor_price": rec.newFloorPrice,
+        "senpi.dsl.new_sl_price": rec.newSLPrice,
+        "senpi.dsl.sl_order_id": rec.slOrderId,
+        "senpi.dsl.current_roe": rec.currentROE,
+        "senpi.dsl.peak_roe": rec.peakROE,
+        "senpi.dsl.locked_profit_pct": rec.lockedProfitPct,
+        "senpi.dsl.close_reason": rec.closeReason,
+        "senpi.dsl.attempt": rec.attempt,
+    });
+}
+/** Map a `dsl.*` transition record to its event. All `info` — failure rides `dsl.closed`'s reason. */
+function buildDslTransitionEvent(transition, payload, nowMs) {
+    const rec = buildDslTransition(transition, payload, nowMs);
+    if (rec === null)
+        return null;
+    const attributes = dslAttributes(rec);
+    const head = rec.asset;
+    const base = { level: "info", attributes };
+    switch (rec.transition) {
+        case "created":
+            return { name: EVENT_NAME.dslCreated, body: `DSL armed ${head}${rec.preset ? ` (${rec.preset})` : ""}`, ...base };
+        case "tier_advanced":
+            return { name: EVENT_NAME.dslTierAdvanced, body: `DSL tier → ${rec.tierIndex ?? "?"} on ${head}`, ...base };
+        case "phase_changed":
+            return { name: EVENT_NAME.dslPhaseChanged, body: `DSL phase → ${rec.phase ?? "?"} on ${head}`, ...base };
+        case "sl_updated":
+            return { name: EVENT_NAME.dslSlUpdated, body: `DSL stop → ${rec.newSLPrice !== undefined ? fmtThousands(rec.newSLPrice) : "?"} on ${head}`, ...base };
+        case "close_pending":
+            return { name: EVENT_NAME.dslClosePending, body: `DSL close pending ${head}${rec.attempt !== undefined ? ` (attempt ${rec.attempt})` : ""}`, ...base };
+        case "closed":
+            return { name: EVENT_NAME.dslClosed, body: `DSL closed ${head}${rec.closeReason ? ` (${rec.closeReason})` : ""}`, ...base };
+        case "deleted":
+            return { name: EVENT_NAME.dslDeleted, body: `DSL deleted ${head}`, ...base };
+        default:
+            // `settings_updated` has no catalog event (not subscribed); ignore defensively.
+            return null;
+    }
+}
+/**
+ * Subscribe the event log to the `position.*` / `dsl.*` domain events on the bus. Each handler builds
+ * its event through {@link emitEvent}'s guard, so a throwing builder or a telemetry failure can never
+ * propagate back through `bus.emit` into the trading path. Mirrors the recording subscriber's wiring;
+ * attach only when telemetry is enabled (per-event assembly on the serial path is dead work otherwise).
+ */
+export function createDomainEventSubscriber(bus) {
+    const handlers = [];
+    function subscribe(event, handler) {
+        bus.on(event, handler);
+        handlers.push({ event, handler });
+    }
+    for (const [event, lifecycleEvent] of Object.entries(POSITION_EVENTS)) {
+        subscribe(event, (payload) => emitEvent(eventLog, () => buildPositionLifecycleEvent(lifecycleEvent, payload, Date.now())));
+    }
+    for (const [event, transition] of Object.entries(DSL_EVENTS)) {
+        subscribe(event, (payload) => emitEvent(eventLog, () => buildDslTransitionEvent(transition, payload, Date.now())));
+    }
+    let disposed = false;
+    return {
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            for (const { event, handler } of handlers)
+                bus.off(event, handler);
+            handlers.length = 0;
+        },
+    };
+}
+// Exported for unit tests — the pure record→event projection, independent of the bus wiring.
+export const __test = { buildPositionLifecycleEvent, buildDslTransitionEvent };
+//# sourceMappingURL=domain-events.js.map

package/dist/runtime/domain-events.js.map

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

package/dist/runtime/lifecycle-events.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Pure builders for the scanner-summary and runtime-lifecycle event-log events. Each returns a fully
+ * built {@link EmittableEvent} (or `null` when the source yields nothing), so the runtime emits with a
+ * single `logger.event` call. Bodies are deterministic narratives; every attribute is a safe scalar.
+ *
+ * The scanner-summary funnel selection is reused from the recording builder ({@link buildScannerSummary})
+ * — no reimplementation of the drop classification.
+ */
+import { EVENT_NAME } from "../utils/event-catalog.js";
+import type { EmittableEvent } from "../actions/event-derivation.js";
+/**
+ * `scanner.summary` from the same `tracking.scanner_run` payload the scanner-complete handler emits.
+ * `null` when the scan considered no candidates (matches the recording builder's anti-spam grain).
+ * Dropped candidates are market data → safe count attributes (`dropped_count` + by-reason), never
+ * `redact`.
+ */
+export declare function buildScannerSummaryEvent(payload: unknown, nowMs: number): EmittableEvent<typeof EVENT_NAME.scannerSummary> | null;
+export interface RuntimeStartedInput {
+    /** Strategy wallet — stamped so out-of-flow lifecycle events route to the per-strategy event store. */
+    readonly address?: string;
+    readonly recipeName?: string;
+    readonly recipeVersion?: string | number;
+    readonly runtimeVersion?: string;
+    readonly scannerCount: number;
+    readonly actionCount: number;
+    readonly hasDsl: boolean;
+    /** Raw, pre-env-resolution config — the form the `senpi.config.hash` is computed over. */
+    readonly unresolvedConfig?: Record<string, unknown>;
+}
+/**
+ * `runtime.started` — carries the UNRESOLVED config hash (the form the recording identity hashes), so
+ * the printed hash matches `senpi.config.hash` on the rows. Emitted at every `Runtime.start()`.
+ */
+export declare function buildRuntimeStartedEvent(input: RuntimeStartedInput): EmittableEvent<typeof EVENT_NAME.runtimeStarted>;
+/** `runtime.stopped` — clean shutdown, with uptime. */
+export declare function buildRuntimeStoppedEvent(runtimeVersion: string | undefined, uptimeMs: number, address?: string): EmittableEvent<typeof EVENT_NAME.runtimeStopped>;
+/** `runtime.paused` — a risk gate tripped a running→paused transition. WARN. */
+export declare function buildRuntimePausedEvent(gateId: string | undefined, gateName: string | undefined, reason: string | undefined, address?: string): EmittableEvent<typeof EVENT_NAME.runtimePaused>;
+/** `runtime.resumed` — a previously-tripped risk gate cleared, re-arming a paused→running transition. */
+export declare function buildRuntimeResumedEvent(gateId: string | undefined, gateName: string | undefined, address?: string): EmittableEvent<typeof EVENT_NAME.runtimeResumed>;
+/** `runtime.error` — an uncaught signal-processing error. ERROR; the message rides `redact`. */
+export declare function buildRuntimeErrorEvent(phase: string, scannerId: string | undefined, message: string): EmittableEvent<typeof EVENT_NAME.runtimeError>;
+//# sourceMappingURL=lifecycle-events.d.ts.map

package/dist/runtime/lifecycle-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-events.d.ts","sourceRoot":"","sources":["../../src/runtime/lifecycle-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,UAAU,EAA6B,MAAM,2BAA2B,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,cAAc,CAAC,GAAG,IAAI,CAoCjI;AAED,MAAM,WAAW,mBAAmB;IAClC,uGAAuG;IACvG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,cAAc,CAAC,CAsBrH;AAED,uDAAuD;AACvD,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,cAAc,CAAC,CAWjK;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,aAAa,CAAC,CAY/L;AAED,yGAAyG;AACzG,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,cAAc,CAAC,CAYrK;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,YAAY,CAAC,CAWpJ"}

package/dist/runtime/lifecycle-events.js

@@ -0,0 +1,139 @@
+/**
+ * Pure builders for the scanner-summary and runtime-lifecycle event-log events. Each returns a fully
+ * built {@link EmittableEvent} (or `null` when the source yields nothing), so the runtime emits with a
+ * single `logger.event` call. Bodies are deterministic narratives; every attribute is a safe scalar.
+ *
+ * The scanner-summary funnel selection is reused from the recording builder ({@link buildScannerSummary})
+ * — no reimplementation of the drop classification.
+ */
+import { buildScannerSummary } from "../recording/wiring/record-builders.js";
+import { computeConfigHash } from "../recording/wiring/identity.js";
+import { EVENT_NAME, eventAttrs } from "../utils/event-catalog.js";
+/** Distinct dropped-reason attribute keys kept on a scanner.summary; the rest fold into `…dropped.other`. */
+const MAX_DROP_REASON_KEYS = 12;
+/**
+ * `scanner.summary` from the same `tracking.scanner_run` payload the scanner-complete handler emits.
+ * `null` when the scan considered no candidates (matches the recording builder's anti-spam grain).
+ * Dropped candidates are market data → safe count attributes (`dropped_count` + by-reason), never
+ * `redact`.
+ */
+export function buildScannerSummaryEvent(payload, nowMs) {
+    const rec = buildScannerSummary(payload, nowMs);
+    if (rec === null)
+        return null;
+    // The record always populates these counts (its optional typing notwithstanding); fall back so the
+    // counts — required attributes — are always defined, and reuse the same values in the body.
+    const passed = rec.passedCount ?? 0;
+    const dropped = rec.droppedCount ?? 0;
+    const total = rec.scannedCount ?? passed + dropped;
+    const attributes = eventAttrs({
+        "senpi.scanner.id": rec.scannerId,
+        "senpi.scanner.scanned_count": total,
+        "senpi.scanner.passed_count": passed,
+        "senpi.scanner.dropped_count": dropped,
+    });
+    // By-reason drop counts → queryable attributes. A scanner's reason vocabulary is normally a small
+    // fixed set, but it is an open producer-controlled string, so the distinct keys are capped: a
+    // scanner that ever templates a value into its reason can't explode attribute-key cardinality on
+    // the collector. Past the cap the remainder folds into one overflow bucket.
+    if (rec.droppedByReason) {
+        const byReason = Object.entries(rec.droppedByReason).sort((a, b) => b[1] - a[1]);
+        let overflow = 0;
+        byReason.forEach(([reason, count], i) => {
+            if (i < MAX_DROP_REASON_KEYS)
+                attributes[`senpi.scanner.dropped.${reason}`] = count;
+            else
+                overflow += count;
+        });
+        if (overflow > 0)
+            attributes["senpi.scanner.dropped.other"] = overflow;
+    }
+    return {
+        name: EVENT_NAME.scannerSummary,
+        level: "info",
+        body: `${rec.scannerId}: ${passed}/${total} passed (${dropped} dropped)`,
+        attributes,
+    };
+}
+/**
+ * `runtime.started` — carries the UNRESOLVED config hash (the form the recording identity hashes), so
+ * the printed hash matches `senpi.config.hash` on the rows. Emitted at every `Runtime.start()`.
+ */
+export function buildRuntimeStartedEvent(input) {
+    const hash = computeConfigHash(input.unresolvedConfig);
+    const version = input.recipeVersion !== undefined ? String(input.recipeVersion) : undefined;
+    const attributes = eventAttrs({
+        "senpi.strategy.address": input.address,
+        "senpi.recipe.name": input.recipeName,
+        "senpi.recipe.version": version,
+        "senpi.config.hash": hash,
+        "senpi.runtime.version": input.runtimeVersion,
+        "senpi.runtime.scanner_count": input.scannerCount,
+        "senpi.runtime.action_count": input.actionCount,
+        "senpi.runtime.has_dsl": input.hasDsl,
+    });
+    const name = input.recipeName ?? "runtime";
+    const versionTag = version ? ` v${version}` : "";
+    const hashTag = hash ? `, config ${hash.slice(0, 7)}…` : "";
+    return {
+        name: EVENT_NAME.runtimeStarted,
+        level: "info",
+        body: `Runtime started: ${name}${versionTag}, ${input.scannerCount} scanners${hashTag}`,
+        attributes,
+    };
+}
+/** `runtime.stopped` — clean shutdown, with uptime. */
+export function buildRuntimeStoppedEvent(runtimeVersion, uptimeMs, address) {
+    return {
+        name: EVENT_NAME.runtimeStopped,
+        level: "info",
+        body: `Runtime stopped after ${Math.round(uptimeMs / 1000)}s`,
+        attributes: eventAttrs({
+            "senpi.strategy.address": address,
+            "senpi.runtime.version": runtimeVersion,
+            "senpi.runtime.uptime_ms": uptimeMs,
+        }),
+    };
+}
+/** `runtime.paused` — a risk gate tripped a running→paused transition. WARN. */
+export function buildRuntimePausedEvent(gateId, gateName, reason, address) {
+    const label = gateName ?? gateId ?? "gate";
+    return {
+        name: EVENT_NAME.runtimePaused,
+        level: "warn",
+        body: `Runtime paused: ${label}${reason ? ` — ${reason}` : ""}`,
+        attributes: eventAttrs({
+            "senpi.strategy.address": address,
+            "senpi.gate.id": gateId,
+            "senpi.gate.name": gateName,
+        }),
+    };
+}
+/** `runtime.resumed` — a previously-tripped risk gate cleared, re-arming a paused→running transition. */
+export function buildRuntimeResumedEvent(gateId, gateName, address) {
+    const label = gateName ?? gateId ?? "gate";
+    return {
+        name: EVENT_NAME.runtimeResumed,
+        level: "info",
+        body: `Runtime resumed: ${label}`,
+        attributes: eventAttrs({
+            "senpi.strategy.address": address,
+            "senpi.gate.id": gateId,
+            "senpi.gate.name": gateName,
+        }),
+    };
+}
+/** `runtime.error` — an uncaught signal-processing error. ERROR; the message rides `redact`. */
+export function buildRuntimeErrorEvent(phase, scannerId, message) {
+    return {
+        name: EVENT_NAME.runtimeError,
+        level: "error",
+        body: `Runtime error in ${phase}`,
+        attributes: eventAttrs({
+            "senpi.runtime.phase": phase,
+            "senpi.scanner.id": scannerId,
+        }),
+        redact: { error: message },
+    };
+}
+//# sourceMappingURL=lifecycle-events.js.map

package/dist/runtime/lifecycle-events.js.map

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

package/dist/runtime/notifications.js

@@ -49,7 +49,7 @@ export function createNotificationService(options) {
                     return;
                 }
                 catch (err) {
-                    logger.warn(`MCP transport failed: ${err instanceof Error ? err.message : String(err)}. Falling back to Gateway HTTP.`);
+                    logger.warn("MCP transport failed; falling back to Gateway HTTP", err);
                 }
             }
             // 2. HTTP Gateway Tool Invocation (Matches your LLM Engine)
@@ -82,7 +82,7 @@ export function createNotificationService(options) {
                     return;
                 }
                 catch (err) {
-                    logger.warn(`Gateway tool invocation failed: ${err instanceof Error ? err.message : String(err)}`);
+                    logger.warn("Gateway tool invocation failed", err);
                 }
                 return;
             }

package/dist/runtime/notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/runtime/notifications.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAA6B,MAAM,sBAAsB,CAAC;AAExF,MAAM,MAAM,GAAG,YAAY,CAAC,6BAA6B,CAAC,CAAC;AAU3D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAAkB,EAClB,GAA0B;IAE1B,OAAO,qBAAqB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAoC;IAC5E,MAAM,MAAM,GAAG,OAAO,OAAO,EAAE,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,wBAAwB,CAAC;IACxG,MAAM,YAAY,GAAG,OAAO,EAAE,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAElF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,6BAA6B,MAAM,sCAAsC,CAAC,CAAC;IACzF,CAAC;IAED,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,OAAe;YAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAEhE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7E,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;YAEzE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;YAED,2DAA2D;YAC3D,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,MAAM,YAAY,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,YAAY,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC5F,OAAO;gBACT,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,CAAC,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;gBAC1H,CAAC;YACH,CAAC;YAED,4DAA4D;YAC5D,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;oBAEhF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,eAAe,EAAE;wBACjD,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE;4BACP,cAAc,EAAE,kBAAkB;4BAClC,eAAe,EAAE,UAAU,YAAY,EAAE;yBAC1C;wBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,IAAI,EAAE,SAAS;4BACf,IAAI,EAAE;gCACJ,MAAM,EAAE,MAAM;gCACd,MAAM,EAAE,YAAY,MAAM,EAAE;gCAC5B,OAAO,EAAE,OAAO;6BACjB;yBACF,CAAC;qBACH,CAAC,CAAC;oBAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;wBACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,CAAC;wBACjE,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;oBACpD,CAAC;oBAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAuD,CAAC;oBACnF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;wBACb,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC1F,CAAC;oBAED,OAAO;gBACT,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,CAAC,mCAAmC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;QACtF,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/runtime/notifications.ts"],"names":[],"mappings":"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"}