@senpi/runtime 3.0.6-dev.runtime-phase-2.20260630134511 → 3.0.6-dev.runtime-phase-2.20260630134536

package/dist/cli/guide-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guide-commands.d.ts","sourceRoot":"","sources":["../../src/cli/guide-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA0cH,eAAO,MAAM,eAAe,QA2HpB,CAAC;AAIT,kFAAkF;AAClF,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;CACxF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CA2CN"}
+{"version":3,"file":"guide-commands.d.ts","sourceRoot":"","sources":["../../src/cli/guide-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA6cH,eAAO,MAAM,eAAe,QAqLpB,CAAC;AAIT,kFAAkF;AAClF,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;CACxF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CA2CN"}

package/dist/cli/guide-commands.js

@@ -23,6 +23,9 @@ Quick commands:
   senpi guide scanners    Scanner types and config fields
   senpi guide actions     Action types and decision modes
   senpi guide dsl         DSL exit: phases, lock modes, tiers, time-based cuts
+  senpi scanner           Per-scanner health: runs, errors, liveness, barren detection
+  senpi events            Local domain-event log — the trade narrative
+  senpi explain <asset>   Stitch one asset's position lifecycle from the event log
   senpi dsl positions     Active DSL positions (CLI inspection)
   senpi dsl inspect       Full DSL state for one asset
   senpi dsl closes        Archived closes with reason
@@ -485,6 +488,16 @@ senpi runtime — Manage runtimes
     --address <wallet>                   Delete by wallet address
   runtime list                         List installed runtimes (id, wallet, source, status)
 
+senpi status — Lightweight runtime health digest
+  status                               Overall health + scanners (with degraded count),
+                                       DSL monitor liveness, risk eligibility + gates
+    -r, --runtime <id>                   Filter by runtime ID
+    --json                               Raw JSON output
+  state                                Full runtime system state — the escape hatch when the
+                                       digest isn't enough (per-component raw state)
+    -r, --runtime <id>                   Filter by runtime ID
+    --json                               Raw JSON output
+
 senpi dsl — Inspect DSL exit engine
   dsl positions                        Active DSL-tracked positions
     -r, --runtime <id>                   Filter by runtime ID
@@ -520,6 +533,47 @@ senpi action — Action layer (execution history, decisions)
     -l, --limit <n>                      Max rows
     --json                               Raw JSON output
 
+senpi risk — Risk eligibility + per-gate status (allowed to trade, and why not)
+  risk                                 Eligibility, gate totals, per-gate status/reason/fault
+    -r, --runtime <id>                   Filter by runtime ID
+    --json                               Raw JSON output
+  risk audit                           Gate-check audit log — per-evaluation pass/CLOSED/COOLDOWN history
+    -r, --runtime <id>                   Runtime ID (required)
+    -a, --address <addr>                 Strategy address (defaults to runtime wallet)
+    --since <iso>                        ISO 8601 lower bound on entry time
+    -l, --limit <n>                      Max entries (default 100)
+    --json                               Raw JSON output
+
+senpi audit — Backend trade-audit trail (MCP tool calls + AI reasoning)
+  audit                                Tool calls with success, duration, reasoning
+    -r, --runtime <id>                   Runtime ID (required)
+    --tool <name>                        Filter by exact tool name
+    --action-type <type>                 read | create | update | delete
+    --success <bool>                     Filter by success (true|false)
+    --since <iso>                        ISO 8601 lower bound on request time
+    --until <iso>                        ISO 8601 upper bound on request time
+    -l, --limit <n>                      Max rows (default 50)
+    --json                               Raw JSON output
+
+senpi events — Local domain-event log (the trade narrative)
+  events                               Position/dsl/order/signal events from the on-disk ring
+    -r, --runtime <id>                   Runtime ID (required)
+    -a, --address <addr>                 Strategy address (defaults to runtime wallet)
+    --name <event>                       Filter by exact event name (e.g. position.opened)
+    --asset <symbol>                     Filter by asset (e.g. BTC)
+    --level <level>                      debug | info | warn | error
+    --since <iso>                        ISO 8601 lower bound on event time
+    --until <iso>                        ISO 8601 upper bound on event time
+    -l, --limit <n>                      Max events (default 200)
+    --json                               Raw JSON output
+
+senpi explain — Stitch one asset's position lifecycle (opened → dsl → closed)
+  explain <asset>                      Chronological event narrative for one asset
+    -r, --runtime <id>                   Runtime ID (required)
+    -a, --address <addr>                 Strategy address (defaults to runtime wallet)
+    -l, --limit <n>                      Max events to scan (default 500)
+    --json                               Raw JSON output
+
 senpi guide — In-shell reference
   guide                                Overview and quick commands
   guide scanners                       Scanner types and config fields
@@ -565,6 +619,13 @@ senpi.listDslArchives
              closeReason, closedAt, peakROE, currentROE, elapsedMinutes, phase }] }
   Close reasons: dsl_breach, hard_timeout, weak_peak_cut, dead_weight_cut, exchange_sl_hit, manual
 
+senpi.getEvents
+  Params:  runtimeId (string, required), address? (string), name? (string), asset? (string),
+           level? ("debug"|"info"|"warn"|"error"), since? (ISO), until? (ISO), limit? (number, default 200)
+  Success: { entries: [{ name, level, body, ts, attrs }], address }
+  Note:    Local on-disk ring at <runtime-state>/strategies/<address>/events/; stores every event's
+           body + capped scalars (the redact free-text slot is collector-only).
+
 senpi.listActions
   Params:  runtimeId? (string), address? (string), actionName? (string)
   Success: { actions: [{ runtimeId, ...ActionLatestState }] }

package/dist/cli/guide-commands.js.map

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

package/dist/cli/senpi-commands.d.ts

@@ -2,12 +2,26 @@
  * OpenClaw CLI commands: openclaw senpi runtime create | list | delete.
  * Thin layer: all three invoke gateway RPCs only; validation and registry live in the gateway.
  */
+import type { RiskAuditEntry } from "../risk/risk-audit-log.js";
+import type { StoredEvent } from "../telemetry/event-store.js";
 /**
  * Register senpi subcommands on the given Commander program.
  */
 export declare function registerSenpiCli(program: {
     command: (name: string, desc?: string) => CommanderCommand | unknown;
 }): void;
+/**
+ * Render the risk audit log as a tab-separated digest (newest entries last,
+ * as returned). Each row: time, source, then `guardrail=result` per
+ * evaluation (with the reason appended for non-pass results).
+ */
+export declare function renderRiskAuditDigest(entries: RiskAuditEntry[]): string;
+export declare function renderEventsDigest(entries: StoredEvent[]): string;
+/**
+ * Stitch an asset's lifecycle: events oldest-first, each line tagged with its position id where one is
+ * present, so a reader can follow opened → dsl transitions → close across one or more positions.
+ */
+export declare function renderExplain(asset: string, entries: StoredEvent[]): string;
 /** Minimal Commander command type for subcommands and options. */
 interface CommanderCommand {
     command(name: string, desc?: string): CommanderCommand;

package/dist/cli/senpi-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"senpi-commands.d.ts","sourceRoot":"","sources":["../../src/cli/senpi-commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,gBAAgB,GAAG,OAAO,CAAA;CAAE,GAChF,IAAI,CA8+BN;AAoMD,kEAAkE;AAClE,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC/D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACtE,MAAM,CACJ,EAAE,EACE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACzD,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACzE,gBAAgB,CAAC;CACrB"}
+{"version":3,"file":"senpi-commands.d.ts","sourceRoot":"","sources":["../../src/cli/senpi-commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,gBAAgB,GAAG,OAAO,CAAA;CAAE,GAChF,IAAI,CAivCN;AA8ID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAWvE;AAmDD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CASjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAW3E;AA8HD,kEAAkE;AAClE,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC/D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACtE,MAAM,CACJ,EAAE,EACE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACzD,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACzE,gBAAgB,CAAC;CACrB"}

package/dist/cli/senpi-commands.js

@@ -659,6 +659,236 @@ export function registerSenpiCli(program) {
                 console.log("");
         }
     });
+    senpi
+        .command("scanner")
+        .description("Per-scanner supervisor health: runs, errors, liveness, barren detection")
+        .option("-r, --runtime <id>", "Filter by runtime id")
+        .option("--json", "Print raw JSON from the gateway")
+        .action(async (opts) => {
+        const params = {};
+        if (typeof opts.runtime === "string" && opts.runtime.length > 0)
+            params.runtimeId = opts.runtime;
+        const data = callGatewayJson("senpi.getSystemState", params);
+        if (!data) {
+            return;
+        }
+        if (data.ok === false) {
+            const err = data.error;
+            console.error(err?.message ?? "Request failed.");
+            process.exitCode = 1;
+            return;
+        }
+        const payload = (data.payload ?? data);
+        const states = selectMany(payload.state, payload.states ?? []);
+        if (opts.json) {
+            const scanners = states.map((s) => ({
+                runtimeId: s.runtimeId ?? s.runtimeName,
+                scanners: s.components?.scanners?.state?.scanners ?? [],
+            }));
+            console.log(JSON.stringify({ ok: true, scanners }, null, 2));
+            return;
+        }
+        if (states.length === 0) {
+            console.log("No running runtime scanners.");
+            return;
+        }
+        for (const state of states) {
+            printScanners(state);
+            if (states.length > 1)
+                console.log("");
+        }
+    });
+    const riskCmd = senpi.command("risk");
+    riskCmd
+        .description("Risk eligibility + per-gate status — am I allowed to trade, and why not")
+        .option("-r, --runtime <id>", "Filter by runtime id")
+        .option("--json", "Print raw JSON from the gateway")
+        .action(async (opts) => {
+        const params = {};
+        if (typeof opts.runtime === "string" && opts.runtime.length > 0)
+            params.runtimeId = opts.runtime;
+        const data = callGatewayJson("senpi.getHealthStatus", params);
+        if (!data) {
+            return;
+        }
+        if (data.ok === false) {
+            const err = data.error;
+            console.error(err?.message ?? "Request failed.");
+            process.exitCode = 1;
+            return;
+        }
+        const payload = (data.payload ?? data);
+        const statuses = selectMany(payload.status, payload.statuses ?? []);
+        if (opts.json) {
+            const risk = statuses.map((s) => ({
+                runtimeId: s.runtimeId ?? s.runtimeName,
+                risk: s.components?.risk ?? null,
+            }));
+            console.log(JSON.stringify({ ok: true, risk }, null, 2));
+            return;
+        }
+        if (statuses.length === 0) {
+            console.log("No running runtime risk status.");
+            return;
+        }
+        for (const status of statuses) {
+            printRisk(status);
+            if (statuses.length > 1)
+                console.log("");
+        }
+    });
+    riskCmd
+        .command("audit")
+        .description("Risk gate-check audit log — per-evaluation pass/CLOSED/COOLDOWN history")
+        .option("-r, --runtime <id>", "Runtime id (required)")
+        .option("-a, --address <addr>", "Strategy address (defaults to runtime wallet)")
+        .option("--since <iso>", "ISO 8601 lower bound on entry time")
+        .option("-l, --limit <n>", "Max entries (default 100)")
+        .option("--json", "Print raw JSON from the gateway")
+        .action(async (opts) => {
+        if (!opts.runtime) {
+            console.error("--runtime <id> is required.");
+            process.exitCode = 1;
+            return;
+        }
+        const params = { runtimeId: opts.runtime };
+        if (opts.address)
+            params.address = opts.address;
+        const limit = opts.limit ? Number.parseInt(opts.limit, 10) : 100;
+        if (Number.isFinite(limit))
+            params.limit = limit;
+        const data = callGatewayJson("senpi.getRiskAudit", params);
+        if (!data) {
+            return;
+        }
+        if (data.ok === false) {
+            const err = data.error;
+            console.error(err?.message ?? "Request failed.");
+            process.exitCode = 1;
+            return;
+        }
+        const inner = (data.payload ?? data);
+        let entries = inner.entries ?? [];
+        // ISO 8601 UTC timestamps sort lexicographically, so a string compare
+        // is a correct lower-bound filter.
+        if (opts.since)
+            entries = entries.filter((e) => e.ts >= opts.since);
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, entries }, null, 2));
+            return;
+        }
+        console.log(renderRiskAuditDigest(entries));
+    });
+    senpi
+        .command("audit")
+        .description("Backend trade-audit trail (MCP tool calls + AI reasoning)")
+        .option("-r, --runtime <id>", "Runtime id (required)")
+        .option("--tool <name>", "Filter by exact tool name")
+        .option("--action-type <type>", "Filter by action type (read|create|update|delete)")
+        .option("--success <bool>", "Filter by success (true|false)")
+        .option("--since <iso>", "ISO 8601 lower bound on request time")
+        .option("--until <iso>", "ISO 8601 upper bound on request time")
+        .option("-l, --limit <n>", "Max rows (default 50)")
+        .option("--json", "Print raw JSON from the gateway")
+        .action(async (opts) => {
+        if (!opts.runtime) {
+            console.error("--runtime <id> is required.");
+            process.exitCode = 1;
+            return;
+        }
+        const params = { runtimeId: opts.runtime };
+        if (opts.tool)
+            params.tool_name = opts.tool;
+        if (opts.actionType)
+            params.action_type = opts.actionType;
+        if (opts.success === "true")
+            params.success = true;
+        else if (opts.success === "false")
+            params.success = false;
+        if (opts.since)
+            params.start_time = opts.since;
+        if (opts.until)
+            params.end_time = opts.until;
+        const limit = opts.limit ? Number.parseInt(opts.limit, 10) : 50;
+        if (Number.isFinite(limit))
+            params.limit = limit;
+        const data = callGatewayJson("senpi.auditQuery", params);
+        if (!data) {
+            return;
+        }
+        if (data.ok === false) {
+            const err = data.error;
+            console.error(err?.message ?? "Request failed.");
+            process.exitCode = 1;
+            return;
+        }
+        const inner = (data.payload ?? data);
+        const result = inner.result ?? { entries: [], count: 0, total: 0, has_more: false };
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, result }, null, 2));
+            return;
+        }
+        if (result.entries.length === 0) {
+            console.log("No audit entries.");
+            return;
+        }
+        console.log("Time\tTool\tType\tOK\tDur(ms)\tReasoning");
+        for (const e of result.entries) {
+            // A malformed backend timestamp makes toISOString() throw RangeError; show a placeholder.
+            const parsed = new Date(e.timestamp);
+            const t = Number.isNaN(parsed.getTime()) ? "—" : parsed.toISOString().slice(11, 19);
+            const dur = e.duration_ms == null ? "—" : String(e.duration_ms);
+            const reason = (e.ai_reasoning ?? "").replace(/\s+/g, " ").slice(0, 60);
+            console.log([t, e.tool, e.action_type, e.success ? "ok" : "FAIL", dur, reason].join("\t"));
+        }
+        if (result.has_more) {
+            console.log(`… more (showing ${result.count} of ~${result.total}; raise -l or use --json)`);
+        }
+    });
+    senpi
+        .command("events")
+        .description("Local domain-event log — the trade narrative (position/dsl/order/signal events)")
+        .option("-r, --runtime <id>", "Runtime id (required)")
+        .option("-a, --address <addr>", "Strategy address (defaults to runtime wallet)")
+        .option("--name <event>", "Filter by exact event name (e.g. position.opened)")
+        .option("--asset <symbol>", "Filter by asset (e.g. BTC)")
+        .option("--level <level>", "Filter by severity (debug|info|warn|error)")
+        .option("--since <iso>", "ISO 8601 lower bound on event time")
+        .option("--until <iso>", "ISO 8601 upper bound on event time")
+        .option("-l, --limit <n>", "Max events (default 200)")
+        .option("--json", "Print raw JSON from the gateway")
+        .action(async (opts) => {
+        const entries = await fetchEvents(opts);
+        if (entries === null)
+            return;
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, entries }, null, 2));
+            return;
+        }
+        console.log(renderEventsDigest(entries));
+    });
+    senpi
+        .command("explain <asset>")
+        .description("Stitch one asset's position lifecycle from the local event log (opened → dsl → closed)")
+        .option("-r, --runtime <id>", "Runtime id (required)")
+        .option("-a, --address <addr>", "Strategy address (defaults to runtime wallet)")
+        .option("-l, --limit <n>", "Max events to scan (default 500)")
+        .option("--json", "Print raw JSON from the gateway")
+        .action(async (asset, opts) => {
+        const entries = await fetchEvents({
+            runtime: opts.runtime,
+            address: opts.address,
+            asset,
+            limit: opts.limit ?? "500",
+        });
+        if (entries === null)
+            return;
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, asset, entries }, null, 2));
+            return;
+        }
+        console.log(renderExplain(asset, entries));
+    });
     // ── Skills subcommand ────────────────────────────────────────────────────────
     const skills = senpi.command("skills");
     skills.description("Manage Senpi skills (status, update)");
@@ -891,12 +1121,23 @@ function printHealthStatus(status) {
     const scannerSummary = scanners?.summary ?? "Scanner summary unavailable.";
     const enabled = typeof scanners?.totals?.enabled === "number" ? scanners.totals.enabled : "?";
     const registered = typeof scanners?.totals?.registered === "number" ? scanners.totals.registered : "?";
+    const degraded = typeof scanners?.totals?.degraded === "number" ? scanners.totals.degraded : 0;
+    const degradedSuffix = degraded > 0 ? `, ${degraded} degraded` : "";
     console.log(`Runtime: ${status.runtimeId ?? status.runtimeName ?? "unknown"}`);
     console.log(`Overall Health: ${status.health ?? "unknown"}`);
     console.log(`Log Level: ${status.logLevel ?? "unknown"}`);
-    console.log(`Scanners: ${scannerSummary} (enabled ${enabled}/${registered})`);
+    console.log(`Scanners: ${scannerSummary} (enabled ${enabled}/${registered}${degradedSuffix})`);
     if (dsl?.summary) {
         console.log(`DSL: ${dsl.summary}`);
+        const monitor = dsl.monitor;
+        if (monitor) {
+            const flight = monitor.inFlight ? " (tick in flight)" : "";
+            const next = monitor.nextTickAt
+                ? `, next tick ${new Date(monitor.nextTickAt).toISOString().slice(11, 19)}`
+                : "";
+            const err = monitor.lastTickError ? ` — last tick error: ${monitor.lastTickError}` : "";
+            console.log(`  Monitor: ${monitor.running ? "running" : "stopped"}${flight}${next}${err}`);
+        }
     }
     if (actions?.summary) {
         const ar = typeof actions.totals?.registered === "number" ? actions.totals.registered : "?";
@@ -904,7 +1145,7 @@ function printHealthStatus(status) {
         console.log(`Actions: ${actions.summary} (registered ${ar}, ${ae} enabled)`);
     }
     if (risk && risk.enabled) {
-        console.log(`Risk Health: ${risk.health}`);
+        console.log(`Risk Eligibility: ${risk.eligibility} | Health: ${risk.health}`);
         console.log("Risk Gates:");
         for (const gate of risk.gates) {
             const label = gate.gateName.padEnd(22);
@@ -913,6 +1154,117 @@ function printHealthStatus(status) {
         }
     }
 }
+function printRisk(status) {
+    const risk = status.components?.risk;
+    console.log(`Runtime: ${status.runtimeId ?? status.runtimeName ?? "unknown"}`);
+    if (!risk || !risk.enabled) {
+        console.log("Risk guardrails: disabled.");
+        return;
+    }
+    console.log(`Eligibility: ${risk.eligibility} | Health: ${risk.health}`);
+    const t = risk.totals;
+    console.log(`Gates: ${t.open} open, ${t.cooldown} cooldown, ${t.closed} closed (${t.fallbackCount} fallback, ${t.failedCount} failed)`);
+    for (const g of risk.gates) {
+        const label = g.gateName.padEnd(22);
+        const reason = g.reason && g.status !== "OPEN" ? ` — ${g.reason}` : "";
+        // Surface evaluation faults the status summary hides: a gate that errored
+        // and the fallback it fell back to.
+        const flag = !g.evaluationOk ? ` [${g.failureKind}${g.fallbackApplied ? ",fallback" : ""}]` : "";
+        console.log(`  ${label}${g.status}${reason}${flag}`);
+    }
+}
+/**
+ * Render the risk audit log as a tab-separated digest (newest entries last,
+ * as returned). Each row: time, source, then `guardrail=result` per
+ * evaluation (with the reason appended for non-pass results).
+ */
+export function renderRiskAuditDigest(entries) {
+    if (entries.length === 0)
+        return "No risk audit.";
+    const lines = ["Time\tSource\tEvaluations"];
+    for (const e of entries) {
+        const t = new Date(e.ts).toISOString().slice(11, 19);
+        const evals = (e.evaluations ?? [])
+            .map((ev) => `${ev.guardrail}=${ev.result}${ev.reason && ev.result !== "pass" ? `(${ev.reason})` : ""}`)
+            .join(" ");
+        lines.push([t, e.source, evals || "—"].join("\t"));
+    }
+    return lines.join("\n");
+}
+/**
+ * Shared fetch for `senpi events` / `senpi explain`: validate --runtime, call senpi.getEvents, and
+ * return the entries. Returns `null` (and sets exitCode/prints) on a missing runtime, transport
+ * failure, or a gateway error — the caller stops.
+ */
+function fetchEvents(opts) {
+    if (!opts.runtime) {
+        console.error("--runtime <id> is required.");
+        process.exitCode = 1;
+        return null;
+    }
+    const params = { runtimeId: opts.runtime };
+    if (opts.address)
+        params.address = opts.address;
+    if (opts.name)
+        params.name = opts.name;
+    if (opts.asset)
+        params.asset = opts.asset;
+    if (opts.level)
+        params.level = opts.level;
+    if (opts.since)
+        params.since = opts.since;
+    if (opts.until)
+        params.until = opts.until;
+    if (opts.limit) {
+        const limit = Number.parseInt(opts.limit, 10);
+        if (Number.isFinite(limit))
+            params.limit = limit;
+    }
+    const data = callGatewayJson("senpi.getEvents", params);
+    if (!data)
+        return null;
+    if (data.ok === false) {
+        const err = data.error;
+        console.error(err?.message ?? "Request failed.");
+        process.exitCode = 1;
+        return null;
+    }
+    const inner = (data.payload ?? data);
+    return inner.entries ?? [];
+}
+/** The asset an event concerns, if any (position/dsl carry `senpi.asset`; signals carry `senpi.signal.asset`). */
+function eventAsset(e) {
+    const a = e.attrs?.["senpi.asset"] ?? e.attrs?.["senpi.signal.asset"];
+    return typeof a === "string" ? a : undefined;
+}
+export function renderEventsDigest(entries) {
+    if (entries.length === 0)
+        return "No events.";
+    const lines = ["Time\tLevel\tEvent\tAsset\tDetail"];
+    for (const e of entries) {
+        const t = new Date(e.ts).toISOString().slice(11, 19);
+        const detail = (e.body ?? "").replace(/\s+/g, " ").slice(0, 60);
+        lines.push([t, e.level, e.name, eventAsset(e) ?? "—", detail].join("\t"));
+    }
+    return lines.join("\n");
+}
+/**
+ * Stitch an asset's lifecycle: events oldest-first, each line tagged with its position id where one is
+ * present, so a reader can follow opened → dsl transitions → close across one or more positions.
+ */
+export function renderExplain(asset, entries) {
+    if (entries.length === 0)
+        return `No events for ${asset}.`;
+    const lines = [`${asset} — ${entries.length} event(s)`];
+    for (const e of entries) {
+        const t = new Date(e.ts).toISOString().slice(11, 19);
+        const pos = typeof e.attrs?.["senpi.position.id"] === "string" ? e.attrs["senpi.position.id"] : undefined;
+        const tag = pos ? ` [pos ${truncateAddr(String(pos))}]` : "";
+        const detail = (e.body ?? "").replace(/\s+/g, " ");
+        lines.push(`  ${t}  ${e.name}\t${detail}${tag}`);
+    }
+    return lines.join("\n");
+}
 function printSystemState(state) {
     const scanners = state.components?.scanners?.state;
     const dsl = state.components?.dsl;
@@ -983,4 +1335,36 @@ function printSystemState(state) {
         }
     }
 }
+function printScanners(state) {
+    const rows = state.components?.scanners?.state?.scanners ?? [];
+    console.log(`Runtime: ${state.runtimeId ?? state.runtimeName ?? "unknown"}`);
+    console.log(`Scanners: ${rows.length}`);
+    for (const s of rows) {
+        // Barren = wired and running but never emitted a signal — a real "alive but producing nothing" gap.
+        const barren = s.health !== "disabled" && (s.runCount ?? 0) > 0 && (s.signalsProduced ?? 0) === 0;
+        // Liveness clock is external-only: n/a for interval scanners, — for an external one not yet heard from.
+        const alive = s.lastAliveAt != null
+            ? String(s.lastAliveAt)
+            : s.scheduleMode === "external"
+                ? "—"
+                : "n/a";
+        console.log([
+            "  scanner",
+            s.scannerId ?? "—",
+            `mode=${s.scheduleMode ?? "—"}`,
+            `health=${s.health ?? "unknown"}`,
+            `enabled=${String(s.enabled ?? false)}`,
+            `inFlight=${String(s.inFlight ?? false)}`,
+            `runs=${s.runCount ?? 0}`,
+            `errors=${s.errorCount ?? 0}`,
+            `consec_errors=${s.consecutiveErrorCount ?? 0}`,
+            `signals=${s.signalsProduced ?? 0}`,
+            `alive=${alive}`,
+            `next=${s.nextRunAt == null ? "—" : String(s.nextRunAt)}`,
+            `last=${s.lastRunStatus ?? "—"}`,
+            ...(s.lastRunReason ? [`reason=${s.lastRunReason}`] : []),
+            ...(barren ? ["BARREN"] : []),
+        ].join(" "));
+    }
+}
 //# sourceMappingURL=senpi-commands.js.map