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

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