feat: operator activity panel + freshness signals + FlashBank LP path

- queries.js: getStatsOverview now exposes operator_activity (counts
  only — liquidation attempts/wins for 24h+7d, builder slots landed
  for 24h/7d/30d, plus per-source data freshness ages). No profit or
  strategy fields are leaked.
- stats.html: new "Seneschal activity — last 24h" panel surfaces
  these in a 6-tile strip beneath the hero KPIs. Freshness coloring
  is signal-aware (slot / continuous / sporadic cadences).
- KPI grid: switched to minmax(0, 1fr) + dedicated auto-fit hero
  strip so a single long sub-label can no longer squish siblings.
- flashloan-providers.js: FlashBank entry now documents the LP /
  commit-capital path (approve + setCommitment, pause anytime).
- tests: +3 new assertions covering operator_activity shape and
  FlashBank lp_path. 75 tests pass.

Author: S. K. Rotwang MMMMMMMMM

README.md

@@ -53,8 +53,8 @@ Nine tools become available to your agent:
 | `seneschal_get_borrower`             | Latest state of one borrower across protocols                        |
 | `seneschal_get_borrower_history`     | Time-series health-factor traces                                     |
 | `seneschal_builder_leaderboard`      | Ethereum builder market share (24h, 7d, 30d, all-time)               |
-| `seneschal_stats_overview`           | Aggregate snapshot powering the public dashboard                     |
-| `seneschal_flashloan_providers`      | Curated catalogue of mainnet flash-loan providers                    |
+| `seneschal_stats_overview`           | Aggregate snapshot powering the public dashboard, incl. operator activity (counts only — no profit fields) |
+| `seneschal_flashloan_providers`      | Curated catalogue of mainnet flash-loan providers, incl. LP-side commit-capital paths where applicable     |
 
 ## REST endpoints
 
@@ -123,10 +123,11 @@ producing the same shapes you can point this server at it.
 npm test
 ```
 
-45 jest tests covering the query layer (in-memory SQLite fixtures), the
+75 jest tests covering the query layer (in-memory SQLite fixtures), the
 Fastify REST routes (via `fastify.inject`), and the MCP server (both
 in-process via `InMemoryTransport` and end-to-end via
-`StreamableHTTPClientTransport`).
+`StreamableHTTPClientTransport`). Plus `test/live-smoke.mjs` which
+exercises the live `mcp.seneschal.space` endpoint over Streamable HTTP.
 
 ## Architecture
 

docs/stats.html

@@ -48,20 +48,29 @@
 @keyframes pulse { from { opacity: .3 } to { opacity: 1 } }
 
 /* ── grid layout ─────────────────────────────────────────── */
-.grid { display: grid; gap: 1em; grid-template-columns: repeat(12, 1fr) }
-.panel { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 1.1em 1.2em }
+/* minmax(0,1fr) instead of 1fr so columns don't stretch when a
+   child's content (e.g. long KPI sub-text) exceeds the column's
+   intrinsic min-width. */
+.grid { display: grid; gap: 1em; grid-template-columns: repeat(12, minmax(0, 1fr)) }
+/* Dedicated KPI strip uses auto-fit so the tiles stay equal-width
+   and gracefully wrap on narrow viewports instead of one card
+   stealing space from its siblings. */
+.kpi-strip { display: grid; gap: 1em; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); margin-bottom: 1em }
+.panel { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 1.1em 1.2em; min-width: 0 }
 .panel h2 { margin: 0 0 .8em; font-size: 0.85em; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--muted) }
 .panel.span-3 { grid-column: span 3 }
 .panel.span-4 { grid-column: span 4 }
+.panel.span-5 { grid-column: span 5 }
 .panel.span-6 { grid-column: span 6 }
+.panel.span-7 { grid-column: span 7 }
 .panel.span-8 { grid-column: span 8 }
 .panel.span-12 { grid-column: span 12 }
 @media (max-width: 900px) {
-	.panel.span-3, .panel.span-4 { grid-column: span 6 }
-	.panel.span-6, .panel.span-8 { grid-column: span 12 }
+	.panel.span-3, .panel.span-4, .panel.span-5 { grid-column: span 6 }
+	.panel.span-6, .panel.span-7, .panel.span-8 { grid-column: span 12 }
 }
 @media (max-width: 540px) {
-	.panel.span-3, .panel.span-4, .panel.span-6 { grid-column: span 12 }
+	.panel.span-3, .panel.span-4, .panel.span-5, .panel.span-6 { grid-column: span 12 }
 }
 
 /* ── KPI tiles ───────────────────────────────────────────── */
@@ -71,6 +80,19 @@
 .kpi-value.warn { color: var(--warn) }
 .kpi-value.bad  { color: var(--bad) }
 
+/* ── operator activity strip ─────────────────────────────── */
+.operator-strip { border-left: 3px solid var(--accent); margin-bottom: 1em }
+.operator-strip-head { display: flex; justify-content: space-between; align-items: baseline; gap: 1em; margin-bottom: 0.9em; flex-wrap: wrap }
+.operator-tiles { display: grid; gap: 0.9em; grid-template-columns: repeat(auto-fit, minmax(170px, 1fr)) }
+.op-tile { background: var(--panel-2); border: 1px solid var(--border); border-radius: 6px; padding: 0.8em 0.9em; min-width: 0 }
+.op-label { color: var(--muted); font-size: 0.78em; letter-spacing: 0.04em; text-transform: uppercase; font-weight: 600 }
+.op-value { font: 600 1.45em/1.15 var(--mono); margin: 0.18em 0 0.1em; color: var(--fg); word-break: break-word }
+.op-value.mono-sm { font-size: 1.05em }
+.op-value.good { color: var(--good) }
+.op-value.warn { color: var(--warn) }
+.op-value.bad  { color: var(--bad) }
+.op-sub { color: var(--muted); font-size: 0.82em }
+
 /* ── tables ──────────────────────────────────────────────── */
 table { width: 100%; border-collapse: collapse; font-size: 0.9em }
 th, td { padding: 0.45em 0.6em; text-align: left }
@@ -120,29 +142,69 @@ <h1>Seneschal — Public Stats</h1>
 
 <div id="error-banner" class="error-banner"></div>
 
-<div class="grid">
-
-	<!-- Hero KPIs -->
-	<div class="panel span-3">
+<div class="kpi-strip">
+	<div class="panel">
 		<h2>Positions tracked</h2>
 		<div id="kpi-positions" class="kpi-value">—</div>
 		<div class="kpi-sub" id="kpi-positions-sub">across Aave + Morpho</div>
 	</div>
-	<div class="panel span-3">
+	<div class="panel">
 		<h2>Total debt watched</h2>
 		<div id="kpi-debt" class="kpi-value">—</div>
 		<div class="kpi-sub" id="kpi-debt-sub">aggregate USD across snapshots</div>
 	</div>
-	<div class="panel span-3">
+	<div class="panel">
 		<h2>At risk (HF &lt; 1.05)</h2>
 		<div id="kpi-atrisk" class="kpi-value">—</div>
 		<div class="kpi-sub" id="kpi-atrisk-sub">live count</div>
 	</div>
-	<div class="panel span-3">
+	<div class="panel">
 		<h2>Liquidations 24 h</h2>
 		<div id="kpi-liq-24h" class="kpi-value">—</div>
 		<div class="kpi-sub" id="kpi-liq-24h-sub">on-chain events observed</div>
 	</div>
+</div>
+
+<section class="operator-strip panel">
+	<header class="operator-strip-head">
+		<h2 style="color:var(--accent);margin:0">Seneschal activity — last 24h</h2>
+		<span class="kpi-sub">counts only — no profit figures exposed</span>
+	</header>
+	<div class="operator-tiles">
+		<div class="op-tile">
+			<div class="op-label">Liquidation attempts</div>
+			<div class="op-value" id="op-attempts">—</div>
+			<div class="op-sub" id="op-attempts-sub">7d: —</div>
+		</div>
+		<div class="op-tile">
+			<div class="op-label">Liquidations won</div>
+			<div class="op-value" id="op-wins">—</div>
+			<div class="op-sub" id="op-wins-sub">win rate —</div>
+		</div>
+		<div class="op-tile">
+			<div class="op-label">Builder blocks landed</div>
+			<div class="op-value" id="op-builder">—</div>
+			<div class="op-sub" id="op-builder-sub">7d / 30d: — / —</div>
+		</div>
+		<div class="op-tile">
+			<div class="op-label">Borrower snapshot age</div>
+			<div class="op-value mono-sm" id="op-snap-age">—</div>
+			<div class="op-sub" id="op-snap-age-sub">writer freshness</div>
+		</div>
+		<div class="op-tile">
+			<div class="op-label">Shadow recorder age</div>
+			<div class="op-value mono-sm" id="op-shadow-age">—</div>
+			<div class="op-sub" id="op-shadow-age-sub">per-slot bid log</div>
+		</div>
+		<div class="op-tile">
+			<div class="op-label">Last execution</div>
+			<div class="op-value mono-sm" id="op-exec-age">—</div>
+			<div class="op-sub" id="op-exec-age-sub">most recent bot action</div>
+		</div>
+	</div>
+</section>
+
+<div class="grid">
 
 	<!-- HF histogram + builder pie -->
 	<div class="panel span-7">
@@ -282,7 +344,7 @@ <h2>Recent on-chain liquidations (last 24 h)</h2>
 		`Aave ${fmtNum(d.totals.borrower_snapshots)} · Morpho ${fmtNum(d.totals.morpho_borrower_snapshots)}`;
 	document.getElementById('kpi-debt').textContent = fmtUSD(k.aave_debt_under_watch_usd);
 	document.getElementById('kpi-debt-sub').textContent =
-		`backed by ${fmtUSD(k.aave_collateral_under_watch_usd)} collateral (Aave V3)`;
+		`with ${fmtUSD(k.aave_collateral_under_watch_usd)} collateral`;
 	const atrisk = k.at_risk_count ?? 0;
 	document.getElementById('kpi-atrisk').textContent = fmtNum(atrisk);
 	document.getElementById('kpi-atrisk').className = 'kpi-value ' + (atrisk > 200 ? 'bad' : atrisk > 50 ? 'warn' : 'good');
@@ -293,6 +355,65 @@ <h2>Recent on-chain liquidations (last 24 h)</h2>
 		`Σ ${fmtUSD(k.liquidations_24h_debt_usd)} debt liquidated`;
 }
 
+function fmtAge(seconds) {
+	if (seconds == null) return '—';
+	if (seconds < 60) return `${seconds}s`;
+	if (seconds < 3600) return `${Math.floor(seconds / 60)}m`;
+	if (seconds < 86400) return `${Math.floor(seconds / 3600)}h ${Math.floor((seconds % 3600) / 60)}m`;
+	return `${Math.floor(seconds / 86400)}d`;
+}
+
+// Different signals have different natural cadences so a single
+// threshold misleads. shadow_blocks_age = per-slot (every ~12s),
+// borrower_snapshot_age = continuous, execution_age = sporadic
+// (only fires when an opportunity arises — minutes-to-hours is fine).
+function freshnessClass(seconds, kind) {
+	if (seconds == null) return 'warn';
+	if (kind === 'slot')      return seconds <   60 ? 'good' : seconds <   300 ? 'warn' : 'bad';
+	if (kind === 'continuous') return seconds <  600 ? 'good' : seconds <  3600 ? 'warn' : 'bad';
+	if (kind === 'sporadic')  return seconds < 6*3600 ? 'good' : seconds < 24*3600 ? 'warn' : 'bad';
+	// fallback
+	return seconds < 600 ? 'good' : seconds < 3600 ? 'warn' : 'bad';
+}
+
+function renderOperator(d) {
+	const op = d.operator_activity ?? {};
+	const attempts = op.liquidation_attempts_24h ?? 0;
+	const wins     = op.liquidations_won_24h ?? 0;
+	const winRate  = op.win_rate_24h;
+
+	const elAttempts = document.getElementById('op-attempts');
+	elAttempts.textContent = fmtNum(attempts);
+	elAttempts.className = 'op-value ' + (attempts > 0 ? 'good' : 'warn');
+	document.getElementById('op-attempts-sub').textContent =
+		`7d: ${fmtNum(op.liquidation_attempts_7d ?? 0)}`;
+
+	const elWins = document.getElementById('op-wins');
+	elWins.textContent = fmtNum(wins);
+	elWins.className = 'op-value ' + (wins > 0 ? 'good' : '');
+	document.getElementById('op-wins-sub').textContent =
+		winRate != null ? `win rate ${(winRate * 100).toFixed(1)}%` : 'win rate —';
+
+	const elBuilder = document.getElementById('op-builder');
+	elBuilder.textContent = fmtNum(op.builder_blocks_landed_24h ?? 0);
+	elBuilder.className = 'op-value ' + ((op.builder_blocks_landed_24h ?? 0) > 0 ? 'good' : 'warn');
+	document.getElementById('op-builder-sub').textContent =
+		`7d / 30d: ${fmtNum(op.builder_blocks_landed_7d ?? 0)} / ${fmtNum(op.builder_blocks_landed_30d ?? 0)}`;
+
+	const fresh = op.data_freshness ?? {};
+	const elSnap = document.getElementById('op-snap-age');
+	elSnap.textContent = fmtAge(fresh.latest_borrower_snapshot_age_s);
+	elSnap.className   = 'op-value mono-sm ' + freshnessClass(fresh.latest_borrower_snapshot_age_s, 'continuous');
+
+	const elShadow = document.getElementById('op-shadow-age');
+	elShadow.textContent = fmtAge(fresh.shadow_blocks_age_s);
+	elShadow.className   = 'op-value mono-sm ' + freshnessClass(fresh.shadow_blocks_age_s, 'slot');
+
+	const elExec = document.getElementById('op-exec-age');
+	elExec.textContent = fmtAge(fresh.latest_execution_age_s);
+	elExec.className   = 'op-value mono-sm ' + freshnessClass(fresh.latest_execution_age_s, 'sporadic');
+}
+
 function renderHfHistogram(d) {
 	const labels = d.hf_histogram.map(b => b.bucket);
 	const aaveCounts   = d.hf_histogram.map(b => b.aave_count);
@@ -461,6 +582,7 @@ <h2>Recent on-chain liquidations (last 24 h)</h2>
 		const d = await r.json();
 		lastOverview = d;
 		renderKpis(d);
+		renderOperator(d);
 		renderHfHistogram(d);
 		renderBuilders(d);
 		renderTopAtRisk(d);

src/flashloan-providers.js

@@ -72,13 +72,28 @@ export const FLASHLOAN_PROVIDERS = Object.freeze([
 		fee_bps: 2,
 		fee_bps_note: "0.02% — configurable per token via setTokenConfig (1–100 bps range)",
 		docs: 'https://flashbank.net',
-		liquidity_note: "Just-in-time model: WETH is pulled from LPs' wallets only during the flash loan, never deposited into a pool. Available liquidity equals the sum of active LP commitments, queryable via `getCommitments(token)`. As of launch, mainnet commitments are 0 — useful if and when LPs arrive.",
+		repo: 'https://github.com/Rotwang9000/flashbank-net',
+		liquidity_note: "Just-in-time model: WETH stays in LPs' wallets and is only pulled for the microseconds of a flash loan. Available liquidity = sum of active LP commitments, queryable via `getCommitments(token)`. Multi-chain (Ethereum, Arbitrum, Base) — see repo for each router address.",
 		supports_multi_asset: false,
 		notable_constraints: [
 			'WETH-first at launch; other ERC-20s require setTokenConfig.',
-			'Provider availability depends on LP commitments — query before assuming liquidity.',
-			'Lower fee than Aave but currently lower liquidity than Balancer + Aave.'
-		]
+			'Provider availability depends on LP commitments — query getCommitments(token) before assuming liquidity.',
+			'Lower fee than Aave but currently lower committed liquidity than Balancer/Aave; will improve as LPs onboard.'
+		],
+		// FlashBank is unique in this catalogue in that anyone can be
+		// liquidity provider with just a wallet approval — no deposit,
+		// no lock-up, no smart-contract custody. Surfaced explicitly
+		// so MEV / treasury agents discovering this catalogue see the
+		// LP path, not just the borrower path.
+		lp_path: {
+			steps: [
+				'Approve `FlashBankRouter` to spend WETH from your wallet (`weth.approve(router, limit)`).',
+				'Call `router.setCommitment(weth, limit, expiry, paused=false)` to advertise how much WETH you will lend.',
+				'Earn the per-flash-loan fee automatically; WETH never leaves your wallet outside of borrow execution.',
+				'Pause anytime with `router.setCommitment(weth, limit, expiry, paused=true)` or drop limit to 0.'
+			],
+			interface_url: 'https://flashbank.net'
+		}
 	},
 	{
 		id: 'uniswap-v3',

src/queries.js

@@ -893,6 +893,26 @@ export async function getStatsOverview(db, params = {}) {
 		FROM missed_liquidations WHERE timestamp >= ?
 	`).get(cutoff24h);
 
+	// Seneschal's own activity over the last 24h. Counts only — we
+	// deliberately do NOT expose total profit in USD or strategy
+	// labels because those are operator-private. The intent is a
+	// "is the bot doing its job?" signal that operators (and curious
+	// outsiders) can see without revealing how much money is at stake.
+	const ourExec24h = db.prepare(`
+		SELECT
+			COUNT(*)                                     AS attempts,
+			COALESCE(SUM(CASE WHEN success=1 THEN 1 ELSE 0 END), 0) AS successes
+		FROM executions
+		WHERE timestamp >= ?
+	`).get(cutoff24h);
+	const ourExec7d = db.prepare(`
+		SELECT
+			COUNT(*)                                     AS attempts,
+			COALESCE(SUM(CASE WHEN success=1 THEN 1 ELSE 0 END), 0) AS successes
+		FROM executions
+		WHERE timestamp >= ?
+	`).get(now - 7 * 24 * 60 * 60 * 1000);
+
 	// At-risk count — anything with HF below 1.05. Aave straight from
 	// snapshots; Morpho synthesised from ltv/lltv.
 	const aaveAtRisk = db.prepare(`
@@ -910,18 +930,53 @@ export async function getStatsOverview(db, params = {}) {
 	// Builder leaderboard for multiple windows so the dashboard can
 	// show trend without persisted history (24h vs 7d delta).
 	const [share24h, share7d, share30d] = await Promise.all([
-		getBuilderLeaderboard({ window: '24h', limit: 8, _shadowPath: shadowPath, _ttlMs: ttlMs }),
-		getBuilderLeaderboard({ window: '7d',  limit: 8, _shadowPath: shadowPath, _ttlMs: ttlMs }),
-		getBuilderLeaderboard({ window: '30d', limit: 8, _shadowPath: shadowPath, _ttlMs: ttlMs })
+		getBuilderLeaderboard({ window: '24h', limit: 50, _shadowPath: shadowPath, _ttlMs: ttlMs }),
+		getBuilderLeaderboard({ window: '7d',  limit: 50, _shadowPath: shadowPath, _ttlMs: ttlMs }),
+		getBuilderLeaderboard({ window: '30d', limit: 50, _shadowPath: shadowPath, _ttlMs: ttlMs })
 	]);
 
+	// Find Seneschal's own row in each window so the operator activity
+	// panel can show "our blocks landed". Matched on the builder label
+	// produced by getBuilderLeaderboard (which normalises extra_data
+	// and known coinbase addresses to a clean display string).
+	const findSelf = (builders) =>
+		builders.find(b => /^seneschal/i.test(b.builder)) ?? { builder: 'seneschal', slots_won: 0, captured_eth: 0 };
+	const selfBuilder24h = findSelf(share24h.builders);
+	const selfBuilder7d  = findSelf(share7d.builders);
+	const selfBuilder30d = findSelf(share30d.builders);
+	// Trim the public leaderboard slice back to top 8 for the donut.
+	share24h.builders = share24h.builders.slice(0, 8);
+	share7d.builders  = share7d.builders.slice(0, 8);
+	share30d.builders = share30d.builders.slice(0, 8);
+
 	// Recent on-chain liquidations (last 24h) — the dashboard renders
 	// this as a feed.
 	const recent24h = recentLiquidations(db, {
 		since_ms: now - 24 * 60 * 60 * 1000,
 		limit: 20
 	});
 
+	// File mtimes for the freshness panel. None of these reveal data
+	// content; they're just "yes, the writer is alive" indicators.
+	const freshness = {
+		shadow_blocks_age_s: fileMtimeMs(shadowPath)
+			? Math.round((now - fileMtimeMs(shadowPath)) / 1000) : null,
+		spark_borrowers_age_s: fileMtimeMs(params._sparkPath)
+			? Math.round((now - fileMtimeMs(params._sparkPath)) / 1000) : null,
+		latest_borrower_snapshot_age_s: (() => {
+			const r = db.prepare(`SELECT max(last_seen_ts) AS t FROM borrower_snapshots`).get();
+			return r?.t ? Math.round((now - r.t) / 1000) : null;
+		})(),
+		latest_execution_age_s: (() => {
+			const r = db.prepare(`SELECT max(timestamp) AS t FROM executions`).get();
+			return r?.t ? Math.round((now - r.t) / 1000) : null;
+		})(),
+		latest_missed_liquidation_age_s: (() => {
+			const r = db.prepare(`SELECT max(timestamp) AS t FROM missed_liquidations`).get();
+			return r?.t ? Math.round((now - r.t) / 1000) : null;
+		})()
+	};
+
 	return {
 		as_of_ms: now,
 		// Pre-aggregated KPI block. The dashboard reads these directly
@@ -938,6 +993,22 @@ export async function getStatsOverview(db, params = {}) {
 			liquidations_24h_count: liqs24h.count,
 			liquidations_24h_debt_usd: liqs24h.debt_usd
 		},
+		// "Are we actually working?" panel. Counts only — never profit.
+		// All numbers here are derivable from on-chain data anyway, so
+		// publishing them gives no edge to competitors but reassures the
+		// operator that the bot is doing its job.
+		operator_activity: {
+			liquidation_attempts_24h: ourExec24h.attempts,
+			liquidations_won_24h:     ourExec24h.successes,
+			win_rate_24h: ourExec24h.attempts > 0
+				? ourExec24h.successes / ourExec24h.attempts : null,
+			liquidation_attempts_7d:  ourExec7d.attempts,
+			liquidations_won_7d:      ourExec7d.successes,
+			builder_blocks_landed_24h: selfBuilder24h.slots_won ?? 0,
+			builder_blocks_landed_7d:  selfBuilder7d.slots_won ?? 0,
+			builder_blocks_landed_30d: selfBuilder30d.slots_won ?? 0,
+			data_freshness: freshness
+		},
 		totals,
 		aave_aggregate: aaveAggregate,
 		hf_histogram: histogram,

test/flashloan-providers.test.js

@@ -25,11 +25,14 @@ describe('FLASHLOAN_PROVIDERS catalogue', () => {
 		}
 	});
 
-	test('FlashBank is included with the documented fee', () => {
+	test('FlashBank is included with the documented fee + LP path', () => {
 		const fb = FLASHLOAN_PROVIDERS.find(p => p.id === 'flashbank');
 		expect(fb).toBeDefined();
 		expect(fb.fee_bps).toBe(2);
 		expect(fb.docs).toContain('flashbank.net');
+		expect(fb.lp_path).toBeDefined();
+		expect(Array.isArray(fb.lp_path.steps)).toBe(true);
+		expect(fb.lp_path.steps.length).toBeGreaterThanOrEqual(3);
 	});
 
 	test('catalogue is frozen — accidental mutation is forbidden', () => {