@wolfstar/cli 2.2.0 → 2.3.0-next-20261004142621

package/dist/{tui-BRddrLQP.js → tui-nldGSD4c.js}

@@ -1,13 +1,34 @@
 import { t as readOwnPackageJson } from "./version-BzclCE19.js";
-import { n as THEME_SETTINGS, o as resolveTheme, r as detectTerminalBackground, t as THEMES } from "./theme-3Fc_LI-2.js";
-import { n as classifyAppLine, r as isErrorDetail } from "./log-buffer-CY82aqnb.js";
+import { n as THEME_SETTINGS, o as resolveTheme, r as detectTerminalBackground, t as THEMES } from "./theme-yS2h5dd_.js";
+import { t as findInstalledVersion } from "./project-zlQStwsf.js";
+import { t as describeCommand } from "./command-diff-BK912Hjc.js";
+import { S as isErrorDetail, _ as windowAround, a as initialLogView, c as levelBadge, d as pinAt, f as pinnedEnd, g as toggleLevel, h as toggleChannel, i as highlight, l as matchesView, m as soloLevel, n as buildRows, o as isChannelVisible, p as soloChannel, r as formatClock, t as VIEW_LEVELS, u as newestErrorRow, v as wrapLabels, x as classifyAppLine } from "./log-view-B7uJEnMR.js";
+import { displayPath } from "@wolfstar/schema";
 import { execFile } from "node:child_process";
 import { stripVTControlCharacters } from "node:util";
 import { Box, Text, render, useInput, useWindowSize } from "ink";
-import { createContext, useContext, useEffect, useMemo, useState } from "react";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { StringDecoder } from "node:string_decoder";
 
+//#region src/dev/tui/ink/hooks/useLogVersion.ts
+/** Bumps whenever the buffer changes, so a consumer can re-derive a filtered view without re-filtering on every render. */
+function useLogVersion(logs) {
+	const [version, setVersion] = useState(0);
+	useEffect(() => {
+		const bump = () => setVersion((current) => current + 1);
+		logs.on("entry", bump);
+		logs.on("clear", bump);
+		bump();
+		return () => {
+			logs.off("entry", bump);
+			logs.off("clear", bump);
+		};
+	}, [logs]);
+	return version;
+}
+
+//#endregion
 //#region src/dev/tui/ink/theme.tsx
 /**
 * `stars dev` decides once whether the UI may use colour (`NO_COLOR`, `FORCE_COLOR`, TTY detection) and which theme
@@ -37,19 +58,808 @@ function useColorEnabled() {
 	return useContext(ThemeContext).color;
 }
 
+//#endregion
+//#region src/dev/tui/ink/components/LogPane.tsx
+const LEVEL_TOKENS$1 = {
+	trace: "trace",
+	debug: "debug",
+	info: "info",
+	success: "success",
+	warn: "warning",
+	error: "error"
+};
+const SEGMENT_TOKENS = {
+	url: "url",
+	path: null,
+	number: "accent",
+	name: "trace",
+	dim: null,
+	ok: "success",
+	warn: "warning",
+	error: "error"
+};
+/** The colours a channel's dot is picked from, by name, so a channel keeps its colour for the whole session. */
+const CHANNEL_TOKENS = [
+	"info",
+	"debug",
+	"trace",
+	"accent",
+	"url",
+	"tunnel"
+];
+function channelToken(channel) {
+	let hash = 0;
+	for (const character of channel) hash = hash * 31 + character.codePointAt(0) >>> 0;
+	return CHANNEL_TOKENS[hash % CHANNEL_TOKENS.length];
+}
+/** The log stream: one line per row, the newest at the bottom unless the view is scrolled. */
+function LogPane({ rows, end, width, height, channelWidth, marked }) {
+	const paint = usePaint();
+	const color = useColorEnabled();
+	const visible = rows.slice(Math.max(0, end - height), end);
+	const gutter = " ".repeat(15 + channelWidth + 1);
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		width,
+		height,
+		overflow: "hidden",
+		justifyContent: "flex-end",
+		children: [visible.length === 0 && /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: " no matching logs"
+		}), visible.map((row, index) => {
+			const key = `${end - visible.length + index}`;
+			if (row.kind === "rule") return /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				wrap: "truncate-end",
+				children: "─".repeat(width)
+			}, key);
+			if (row.kind === "header") return /* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				children: [/* @__PURE__ */ jsx(Text, {
+					bold: true,
+					color: paint(channelToken(row.channel)),
+					children: ` ${row.channel}`
+				}), /* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: ` · ${row.count}`
+				})]
+			}, key);
+			const { entry } = row;
+			const failed = entry.level === "error";
+			if (row.kind === "detail") return /* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				children: [
+					gutter,
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: "│ "
+					}),
+					/* @__PURE__ */ jsx(Message, {
+						text: row.text,
+						channel: entry.channel,
+						color: failed ? paint("error") : void 0,
+						dim: !failed
+					})
+				]
+			}, key);
+			const level = LEVEL_TOKENS$1[entry.level];
+			return /* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				children: [
+					color ? /* @__PURE__ */ jsx(Text, {
+						bold: true,
+						backgroundColor: paint(level),
+						color: paint(failed ? "onError" : "onBright"),
+						children: ` ${levelBadge(entry.level)} `
+					}) : /* @__PURE__ */ jsx(Text, {
+						bold: true,
+						children: `[${levelBadge(entry.level)}]`
+					}),
+					/* @__PURE__ */ jsx(Text, {
+						color: paint("brand"),
+						children: entry.id === marked ? "▎" : " "
+					}),
+					" ",
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: !failed,
+						color: failed ? paint("error") : void 0,
+						children: formatClock(entry.time)
+					}),
+					"  ",
+					/* @__PURE__ */ jsx(Text, {
+						bold: failed,
+						color: failed ? paint("error") : void 0,
+						children: entry.channel.slice(0, channelWidth).padStart(channelWidth)
+					}),
+					" ",
+					/* @__PURE__ */ jsx(Text, {
+						color: paint(channelToken(entry.channel)),
+						children: "●"
+					}),
+					" ",
+					/* @__PURE__ */ jsx(Message, {
+						text: row.text,
+						channel: entry.channel,
+						color: entry.level === "warn" ? paint("warning") : void 0
+					})
+				]
+			}, key);
+		})]
+	});
+}
+function Message({ text, channel, color, dim = false }) {
+	const paint = usePaint();
+	return /* @__PURE__ */ jsx(Text, {
+		color,
+		dimColor: dim,
+		children: highlight(text, channel).map((segment, index) => {
+			if (segment.token === void 0) return segment.text;
+			const token = SEGMENT_TOKENS[segment.token];
+			return /* @__PURE__ */ jsx(Text, {
+				color: token === null ? color : paint(token),
+				dimColor: token === null || dim,
+				bold: segment.token === "name",
+				children: segment.text
+			}, index);
+		})
+	});
+}
+
+//#endregion
+//#region src/dev/tui/ink/components/PromptCard.tsx
+/** The rows a prompt takes, border included, so the log pane above it can be sized. */
+function promptHeight(prompt, available) {
+	return Math.min(Math.max(4, available), prompt.changes.length + 4);
+}
+/**
+* The card under the log stream that asks before the bot's commands are deployed again: a redeploy changes what
+* every user of the application sees, so it is never done behind the developer's back.
+*/
+function PromptCard({ prompt, width, height }) {
+	const paint = usePaint();
+	const room = Math.max(0, height - 4);
+	const shown = prompt.changes.slice(0, prompt.changes.length > room ? Math.max(0, room - 1) : room);
+	const more = prompt.changes.length - shown.length;
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		width,
+		height,
+		borderStyle: "single",
+		borderColor: paint("accent"),
+		paddingX: 1,
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				color: paint("accent"),
+				wrap: "truncate-end",
+				children: "Commands updated:"
+			}),
+			shown.map((change) => /* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				children: [
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: "- "
+					}),
+					/* @__PURE__ */ jsx(Text, {
+						color: paint(change.kind === "removed" ? "error" : change.kind === "added" ? "success" : "url"),
+						children: describeCommand(change)
+					}),
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: ` ${change.kind}`
+					})
+				]
+			}, `${change.guild}:${change.type}:${change.name}`)),
+			more > 0 && /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: `  and ${more} more`
+			}),
+			/* @__PURE__ */ jsxs(Text, {
+				wrap: "truncate-end",
+				children: ["Refresh commands? ", /* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: "(y/n)"
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/dev/tui/panel-logic.ts
+/** Whether the badge describes work in progress, as opposed to a state the session rests in. */
+function isBusy(badge) {
+	return badge === "starting" || badge === "building" || badge === "restarting";
+}
+/**
+* The badge and standing description for the panel's status row, mirroring the states Nuxt CLI v4's own dev panel
+* cycles through (`STARTING`/`BUILDING`/`RESTART`/`READY`/`ERROR`).
+*/
+function describeBadge(status) {
+	if (status.build === "building") return {
+		badge: status.startedAt === null ? "starting" : "building",
+		note: status.progress.message
+	};
+	if (status.process === "starting") return {
+		badge: "starting",
+		note: "starting the bot"
+	};
+	if (status.paused) return {
+		badge: "stopped",
+		note: "the bot is stopped, press r to start it"
+	};
+	if (status.process === "stopping") return {
+		badge: "restarting",
+		note: "restarting the bot"
+	};
+	if (status.build === "failed") return {
+		badge: "error",
+		note: "build failed, waiting for changes"
+	};
+	if (status.process === "crashed") return {
+		badge: "error",
+		note: "the bot crashed, press r to restart"
+	};
+	if (status.health === "down") return {
+		badge: "error",
+		note: "health check failed"
+	};
+	if (status.typecheck === "failed") return {
+		badge: "error",
+		note: "type check failed, press e to view it"
+	};
+	if (status.process === "stopped") return {
+		badge: "error",
+		note: "the bot stopped, press r to restart"
+	};
+	if (status.progress.fraction < 1) return {
+		badge: "starting",
+		note: status.progress.message
+	};
+	if (status.process === "running") return {
+		badge: "ready",
+		note: "watching for changes"
+	};
+	return {
+		badge: "starting",
+		note: "waiting for the first build"
+	};
+}
+/** Formats an uptime the way a status line reads it: `35s`, `3m 35s`, `2h 04m`. */
+function formatUptime(milliseconds) {
+	const total = Math.max(0, Math.floor(milliseconds / 1e3));
+	const seconds = total % 60;
+	const minutes = Math.floor(total / 60) % 60;
+	const hours = Math.floor(total / 3600);
+	if (hours > 0) return `${hours}h ${minutes.toString().padStart(2, "0")}m`;
+	return minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+}
+/** Formats a duration the way a dev session reads it: `mm:ss` under an hour, `h:mm:ss` above. */
+function formatDuration(milliseconds) {
+	const total = Math.max(0, Math.floor(milliseconds / 1e3));
+	const seconds = total % 60;
+	const minutes = Math.floor(total / 60) % 60;
+	const hours = Math.floor(total / 3600);
+	const pad = (value) => value.toString().padStart(2, "0");
+	return hours > 0 ? `${hours}:${pad(minutes)}:${pad(seconds)}` : `${pad(minutes)}:${pad(seconds)}`;
+}
+
+//#endregion
+//#region src/dev/tui/ink/hooks/useUptime.ts
+/**
+* Re-renders once a second while the bot is up, so the uptime in the header keeps counting.
+*/
+function useUptime(startedAt) {
+	const [now, setNow] = useState(() => Date.now());
+	useEffect(() => {
+		if (startedAt === null) return;
+		setNow(Date.now());
+		const timer = setInterval(() => setNow(Date.now()), 1e3);
+		return () => clearInterval(timer);
+	}, [startedAt]);
+	return startedAt === null ? null : now - startedAt;
+}
+
+//#endregion
+//#region src/dev/tui/ink/components/Sidebar.tsx
+const LEVEL_TOKENS = {
+	error: "error",
+	warn: "warning",
+	info: "info",
+	debug: "debug",
+	trace: "trace"
+};
+const SPINNER = [
+	"⠋",
+	"⠙",
+	"⠹",
+	"⠸",
+	"⠼",
+	"⠴",
+	"⠦",
+	"⠧",
+	"⠇",
+	"⠏"
+];
+const KEYS$1 = [[
+	["←→", "select"],
+	["tab", "group"],
+	["space", "filter"],
+	["s", "solo"]
+], [
+	["q", "quit"],
+	["r", "restart"],
+	["d", "disconnect"],
+	["c", "clear"],
+	["↑↓", "scroll"],
+	["g/G", "top/bottom"],
+	["?", "help"]
+]];
+let frameworkVersion = null;
+/** Looked up once per project: it walks `node_modules`, and the sidebar repaints on every log entry. */
+function readFrameworkVersion(root) {
+	if (frameworkVersion?.root !== root) frameworkVersion = {
+		root,
+		version: findInstalledVersion(root, "@wolfstar/http-framework")
+	};
+	return frameworkVersion.version;
+}
+/**
+* The left column of the dashboard: what the session is doing, the filters of the log stream, and the keys. Under a
+* short terminal the key help goes first, then the filters' own hints: the status and the filters are what it is for.
+*/
+function Sidebar(props) {
+	const { status, config, counters, filter, channels, focus, collapsed, live, grouped, frame, elapsedMs, width, height, confirmQuit } = props;
+	const paint = usePaint();
+	const uptime = useUptime(status.startedAt);
+	const state = describeBadge(status);
+	const busy = isBusy(state.badge);
+	const failed = state.badge === "error";
+	const name = config.packageJson?.name ?? "stars project";
+	const inner = Math.max(1, width - 2);
+	const row = (label, value, key = label) => /* @__PURE__ */ jsxs(Text, {
+		wrap: "truncate-end",
+		children: [/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: label.padEnd(8)
+		}), value]
+	}, key);
+	const stateColor = paint(failed ? "error" : busy || state.badge === "stopped" ? "busy" : "success");
+	const tunnel = status.tunnel === "up" ? /* @__PURE__ */ jsx(Text, {
+		color: paint("tunnel"),
+		children: "live"
+	}) : status.tunnel === "starting" ? /* @__PURE__ */ jsx(Text, {
+		color: paint("busy"),
+		children: "connecting"
+	}) : status.tunnel === "failed" ? /* @__PURE__ */ jsx(Text, {
+		color: paint("error"),
+		children: "failed"
+	}) : /* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "off"
+	});
+	const port = status.port ?? (status.url ? new URL(status.url).port || null : null);
+	const framework = readFrameworkVersion(config.root);
+	const head = [
+		/* @__PURE__ */ jsxs(Text, {
+			wrap: "truncate-end",
+			children: [/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				color: paint("brand"),
+				children: name
+			}), /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: ` • stars v${readOwnPackageJson().version}`
+			})]
+		}, "title"),
+		/* @__PURE__ */ jsx(Text, { children: " " }, "gap-title"),
+		/* @__PURE__ */ jsxs(Text, {
+			wrap: "truncate-end",
+			children: [
+				/* @__PURE__ */ jsx(Text, {
+					color: stateColor,
+					children: busy ? SPINNER[frame % SPINNER.length] : failed ? "✖" : "●"
+				}),
+				" ",
+				/* @__PURE__ */ jsx(Text, {
+					bold: true,
+					color: stateColor,
+					children: confirmQuit ? "quit?" : state.badge === "ready" ? "running" : state.badge
+				}),
+				busy && /* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: ` ${Math.round(status.progress.fraction * 100)}% · ${(elapsedMs / 1e3).toFixed(1)}s`
+				})
+			]
+		}, "state"),
+		/* @__PURE__ */ jsx(Text, {
+			wrap: "truncate-end",
+			children: confirmQuit ? /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "press y to confirm, esc to stay"
+			}) : state.badge === "ready" ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				children: name
+			}), " is ready!"] }) : /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: state.note
+			})
+		}, "note"),
+		row("http", framework ? `v${framework}` : /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "not installed"
+		})),
+		row("up", uptime === null ? /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "—"
+		}) : formatUptime(uptime)),
+		row("port", port ?? /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "—"
+		})),
+		row("tunnel", tunnel),
+		row("logs", config.dev.logFile ? displayPath(config.root, config.dev.logFile) : /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "off"
+		})),
+		...config.dev.typecheck.enabled ? [row("types", status.typecheck === "failed" ? /* @__PURE__ */ jsx(Text, {
+			color: paint("error"),
+			children: `${status.typeErrors} ${status.typeErrors === 1 ? "error" : "errors"}`
+		}) : status.typecheck)] : [],
+		...counters.errors > 0 || counters.warnings > 0 ? [/* @__PURE__ */ jsxs(Text, {
+			wrap: "truncate-end",
+			children: [counters.errors > 0 && /* @__PURE__ */ jsx(Text, {
+				bold: true,
+				color: paint("error"),
+				children: `✖ ${counters.errors} `
+			}), counters.warnings > 0 && /* @__PURE__ */ jsx(Text, {
+				color: paint("warning"),
+				children: `⚠ ${counters.warnings}`
+			})]
+		}, "counters")] : []
+	];
+	const groupHeader = (group, suffix = "") => /* @__PURE__ */ jsxs(Text, {
+		wrap: "truncate-end",
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: focus.group === group ? paint("brand") : void 0,
+				children: collapsed[group] ? "▸" : "▾"
+			}),
+			" ",
+			/* @__PURE__ */ jsx(Text, {
+				bold: focus.group === group,
+				dimColor: focus.group !== group,
+				children: group
+			}),
+			group === "channels" && grouped && /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: " · grouped"
+			}),
+			suffix && /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: suffix
+			})
+		]
+	}, `${group}-header`);
+	const item = (group, index, label, on, token) => {
+		const focused = focus.group === group && focus.index === index;
+		return /* @__PURE__ */ jsx(Text, {
+			color: on ? paint(token) : void 0,
+			dimColor: !on,
+			strikethrough: !on,
+			underline: focused,
+			bold: focused,
+			children: label
+		}, label);
+	};
+	const budget = Math.max(1, height - 1);
+	const labelWidth = Math.max(1, inner - 2);
+	const lines = (group, labels, nodes, range = [0, Infinity]) => wrapLabels(labels, labelWidth).slice(...range).map((line, index) => /* @__PURE__ */ jsxs(Text, {
+		wrap: "truncate-end",
+		children: ["  ", line.flatMap((label, position) => position > 0 ? [" ", nodes[label]] : [nodes[label]])]
+	}, `${group}-${index}`));
+	const levelNodes = VIEW_LEVELS.map((level, index) => item("levels", index, level, filter.levels.has(level), LEVEL_TOKENS[level]));
+	const levelLines = collapsed.levels ? [] : lines("levels", VIEW_LEVELS, levelNodes);
+	const channelNodes = channels.map((channel, index) => item("channels", index, channel, isChannelVisible(filter, channel), channelToken(channel)));
+	const channelLayout = wrapLabels(channels, labelWidth);
+	const focusedLine = focus.group === "channels" ? Math.max(0, channelLayout.findIndex((line) => line.includes(focus.index))) : 0;
+	const range = windowAround(channelLayout.length, focusedLine, Math.max(1, budget - head.length - 3 - levelLines.length));
+	const hiddenChannels = channelLayout.length - (range[1] - range[0]);
+	const filters = [
+		/* @__PURE__ */ jsx(Text, { children: " " }, "gap-filters"),
+		groupHeader("channels", !collapsed.channels && hiddenChannels > 0 ? ` · ${range[0] + 1}-${range[1]}/${channelLayout.length}` : ""),
+		...collapsed.channels ? [] : lines("channels", channels, channelNodes, range),
+		groupHeader("levels"),
+		...levelLines
+	];
+	const keys = KEYS$1.map((section, sectionIndex) => [/* @__PURE__ */ jsx(Text, { children: " " }, `gap-keys-${sectionIndex}`), ...section.map(([key, label]) => /* @__PURE__ */ jsxs(Text, {
+		wrap: "truncate-end",
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				color: paint("url"),
+				children: key
+			}),
+			" ",
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: label
+			})
+		]
+	}, key))]);
+	let body = [
+		...head,
+		...filters,
+		...keys.flat()
+	];
+	if (body.length > budget) body = [
+		...head,
+		...filters,
+		...keys[1]
+	];
+	if (body.length > budget) body = [...head, ...filters];
+	body = body.slice(0, budget);
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		width,
+		height,
+		paddingX: 1,
+		children: [
+			body.map((node, index) => /* @__PURE__ */ jsx(Box, {
+				height: 1,
+				width: inner,
+				children: node
+			}, index)),
+			/* @__PURE__ */ jsx(Box, { flexGrow: 1 }),
+			/* @__PURE__ */ jsx(Box, {
+				height: 1,
+				width: inner,
+				justifyContent: "flex-end",
+				children: /* @__PURE__ */ jsxs(Text, {
+					wrap: "truncate-end",
+					children: [
+						/* @__PURE__ */ jsx(Text, {
+							color: paint(live ? "error" : "busy"),
+							children: "●"
+						}),
+						" ",
+						/* @__PURE__ */ jsx(Text, {
+							dimColor: true,
+							children: live ? "live" : "paused"
+						})
+					]
+				})
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/dev/tui/ink/components/Dashboard.tsx
+/** The sidebar takes about a quarter of the terminal, within what its longest lines need and can spare. */
+function sidebarWidth(columns) {
+	return Math.max(24, Math.min(34, Math.floor(columns * .26)));
+}
+/**
+* The full-screen dev view: the session's state and the log filters on the left, the log stream on the right, and a
+* card under the stream when `stars dev` has something to ask. Everything it shows comes from the service; the keys
+* here only change what is looked at.
+*/
+function Dashboard(props) {
+	const { service, status, counters, frame, elapsedMs, width, height, confirmQuit, initialFilter, active, onCapture } = props;
+	const paint = usePaint();
+	const [filter, setFilter] = useState(initialFilter);
+	const [focus, setFocus] = useState({
+		group: "channels",
+		index: 0
+	});
+	const [collapsed, setCollapsed] = useState({
+		channels: false,
+		levels: false
+	});
+	const [grouped, setGrouped] = useState(false);
+	const [searching, setSearching] = useState(false);
+	const [pinned, setPinned] = useState(null);
+	const [marked, setMarked] = useState(null);
+	const version = useLogVersion(service.logs);
+	const channels = useMemo(() => [.../* @__PURE__ */ new Set([...initialFilter.allow ?? [], ...service.logs.channels()])].sort(), [
+		service,
+		initialFilter,
+		version
+	]);
+	const rows = useMemo(() => buildRows(service.logs.entries().filter((entry) => matchesView(entry, filter)), { group: grouped }), [
+		service,
+		filter,
+		grouped,
+		version
+	]);
+	useEffect(() => {
+		onCapture(searching);
+		return () => onCapture(false);
+	}, [searching, onCapture]);
+	const side = sidebarWidth(width);
+	const mainWidth = Math.max(1, width - side - 1);
+	const searchRows = searching || filter.query ? 1 : 0;
+	const cardRows = status.prompt ? promptHeight(status.prompt, Math.max(4, height - searchRows - 3)) : 0;
+	const paneHeight = Math.max(1, height - searchRows - cardRows);
+	const end = pinnedEnd(rows, pinned, paneHeight);
+	const channelWidth = Math.min(12, Math.max(3, ...channels.map((channel) => channel.length)));
+	const items = focus.group === "channels" ? channels : VIEW_LEVELS;
+	const change = (next) => {
+		setFilter(next);
+		setPinned(null);
+	};
+	const scroll = (delta) => {
+		setPinned(pinAt(rows, Math.max(Math.min(paneHeight, rows.length), end + delta)));
+	};
+	useInput((input, key) => {
+		if (key.ctrl || confirmQuit) return;
+		if (searching) {
+			if (key.escape) {
+				setSearching(false);
+				change({
+					...filter,
+					query: ""
+				});
+			} else if (key.return) setSearching(false);
+			else if (key.backspace || key.delete) change({
+				...filter,
+				query: [...filter.query].slice(0, -1).join("")
+			});
+			else if (input && !key.upArrow && !key.downArrow && !key.leftArrow && !key.rightArrow && !key.tab) change({
+				...filter,
+				query: filter.query + input
+			});
+			return;
+		}
+		if (key.escape) {
+			if (filter.query) change({
+				...filter,
+				query: ""
+			});
+			else setPinned(null);
+			return setMarked(null);
+		}
+		if (input === "/") return setSearching(true);
+		if (key.tab) return setFocus((current) => ({
+			group: current.group === "channels" ? "levels" : "channels",
+			index: 0
+		}));
+		if (key.leftArrow || key.rightArrow) {
+			if (items.length === 0) return;
+			const delta = key.leftArrow ? -1 : 1;
+			return setFocus((current) => ({
+				...current,
+				index: (current.index + delta + items.length) % items.length
+			}));
+		}
+		if (key.return) return setCollapsed((current) => ({
+			...current,
+			[focus.group]: !current[focus.group]
+		}));
+		if (input === " " || input === "s") {
+			const target = items[Math.min(focus.index, items.length - 1)];
+			if (target === void 0) return;
+			if (focus.group === "channels") return change(input === " " ? toggleChannel(filter, target) : soloChannel(filter, target));
+			const level = target;
+			return change(input === " " ? toggleLevel(filter, level) : soloLevel(filter, level));
+		}
+		if (input === "a") return change({
+			...filter,
+			allow: null,
+			hidden: /* @__PURE__ */ new Set(),
+			levels: new Set(VIEW_LEVELS),
+			query: ""
+		});
+		if (input === "b") {
+			setGrouped((current) => !current);
+			return setPinned(null);
+		}
+		if (key.upArrow || input === "k") return scroll(-1);
+		if (key.downArrow || input === "j") return scroll(1);
+		if (key.pageUp) return scroll(-Math.max(1, paneHeight - 1));
+		if (key.pageDown) return scroll(Math.max(1, paneHeight - 1));
+		if (key.home || input === "g") return setPinned(pinAt(rows, Math.min(paneHeight, rows.length)));
+		if (key.end || input === "G") return setPinned(null);
+		if (input === "e") {
+			const index = newestErrorRow(rows);
+			if (index < 0) return;
+			const row = rows[index];
+			setMarked(row.kind === "entry" ? row.entry.id : null);
+			setPinned(pinAt(rows, Math.max(paneHeight, index + Math.ceil(paneHeight / 2))));
+		}
+	}, { isActive: active });
+	return /* @__PURE__ */ jsxs(Box, {
+		width,
+		height,
+		children: [/* @__PURE__ */ jsx(Sidebar, {
+			status,
+			config: service.config,
+			counters,
+			filter,
+			channels,
+			focus,
+			collapsed,
+			live: pinned === null,
+			grouped,
+			frame,
+			elapsedMs,
+			width: side,
+			height,
+			confirmQuit
+		}), /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "column",
+			width: mainWidth + 1,
+			height,
+			borderStyle: "single",
+			borderTop: false,
+			borderRight: false,
+			borderBottom: false,
+			borderDimColor: true,
+			children: [
+				/* @__PURE__ */ jsx(LogPane, {
+					rows,
+					end,
+					width: mainWidth,
+					height: paneHeight,
+					channelWidth,
+					marked
+				}),
+				status.prompt && /* @__PURE__ */ jsx(PromptCard, {
+					prompt: status.prompt,
+					width: mainWidth,
+					height: cardRows
+				}),
+				searchRows > 0 && /* @__PURE__ */ jsxs(Text, {
+					wrap: "truncate-end",
+					children: [
+						/* @__PURE__ */ jsx(Text, {
+							bold: true,
+							color: paint("url"),
+							children: " / "
+						}),
+						filter.query,
+						searching ? "▏" : /* @__PURE__ */ jsx(Text, {
+							dimColor: true,
+							children: " · esc clears"
+						})
+					]
+				})
+			]
+		})]
+	});
+}
+
 //#endregion
 //#region src/dev/tui/ink/components/HelpOverlay.tsx
 const KEYS = [
 	["r", "restart the bot now"],
+	["d", "disconnect: stop the bot until the next r"],
 	["o", "open the local URL in a browser"],
 	["t", "toggle the public tunnel"],
 	["i", "show versions, URLs and session info"],
 	["T", "pick a colour theme (dark, light, colour-blind friendly, ANSI)"],
-	["l", "open the logs (scroll, filter by source or level)"],
+	["v", "switch between the dashboard and the compact panel"],
+	["l", "open the logs (select, copy, filter by source or level)"],
 	["e", "jump to the last error, keeping its context"],
+	["y / n", "answer a prompt (refresh the commands)"],
 	["c / Ctrl+L", "clear the log history"],
 	["q / Ctrl+C", "stop the bot and quit"],
-	["?", "toggle this help"]
+	["?", "toggle this help"],
+	["", ""],
+	["dashboard", ""],
+	["← / →", "select a channel or a level"],
+	["tab", "switch between channels and levels"],
+	["space", "show or hide the selected one"],
+	["s", "solo: only the selected one, again for all"],
+	["a", "show every channel and level"],
+	["enter", "fold or unfold the selected group"],
+	["b", "group the stream by channel"],
+	["↑ / ↓", "scroll (PgUp/PgDn by page)"],
+	["g / G", "top / back to live"],
+	["/", "search (Esc clears)"]
 ];
 /** The static keys reference, opened with `?` from the pinned panel. */
 function HelpOverlay({ height, width, onClose }) {
@@ -73,7 +883,7 @@ function HelpOverlay({ height, width, onClose }) {
 				dimColor: true,
 				children: "─".repeat(width)
 			}),
-			KEYS.slice(0, Math.max(0, height - 3)).map(([key, description]) => /* @__PURE__ */ jsxs(Text, {
+			KEYS.slice(0, Math.max(0, height - 3)).map(([key, description], index) => /* @__PURE__ */ jsxs(Text, {
 				wrap: "truncate-end",
 				children: [
 					"  ",
@@ -87,7 +897,7 @@ function HelpOverlay({ height, width, onClose }) {
 						children: description
 					})
 				]
-			}, key)),
+			}, index)),
 			/* @__PURE__ */ jsx(Box, { flexGrow: 1 }),
 			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
@@ -97,24 +907,6 @@ function HelpOverlay({ height, width, onClose }) {
 	});
 }
 
-//#endregion
-//#region src/dev/tui/ink/hooks/useLogVersion.ts
-/** Bumps whenever the buffer changes, so a consumer can re-derive a filtered view without re-filtering on every render. */
-function useLogVersion(logs) {
-	const [version, setVersion] = useState(0);
-	useEffect(() => {
-		const bump = () => setVersion((current) => current + 1);
-		logs.on("entry", bump);
-		logs.on("clear", bump);
-		bump();
-		return () => {
-			logs.off("entry", bump);
-			logs.off("clear", bump);
-		};
-	}, [logs]);
-	return version;
-}
-
 //#endregion
 //#region src/dev/tui/ink/components/Hints.tsx
 const PANEL_HINTS = [
@@ -350,84 +1142,6 @@ function useDevStatus(service) {
 	return status;
 }
 
-//#endregion
-//#region src/dev/tui/ink/hooks/useUptime.ts
-/**
-* Re-renders once a second while the bot is up, so the uptime in the header keeps counting.
-*/
-function useUptime(startedAt) {
-	const [now, setNow] = useState(() => Date.now());
-	useEffect(() => {
-		if (startedAt === null) return;
-		setNow(Date.now());
-		const timer = setInterval(() => setNow(Date.now()), 1e3);
-		return () => clearInterval(timer);
-	}, [startedAt]);
-	return startedAt === null ? null : now - startedAt;
-}
-
-//#endregion
-//#region src/dev/tui/panel-logic.ts
-/**
-* The badge and standing description for the panel's status row, mirroring the states Nuxt CLI v4's own dev panel
-* cycles through (`STARTING`/`BUILDING`/`RESTART`/`READY`/`ERROR`).
-*/
-function describeBadge(status) {
-	if (status.build === "building") return {
-		badge: status.startedAt === null ? "starting" : "building",
-		note: status.progress.message
-	};
-	if (status.process === "starting") return {
-		badge: "starting",
-		note: "starting the bot"
-	};
-	if (status.process === "stopping") return {
-		badge: "restarting",
-		note: "restarting the bot"
-	};
-	if (status.build === "failed") return {
-		badge: "error",
-		note: "build failed, waiting for changes"
-	};
-	if (status.process === "crashed") return {
-		badge: "error",
-		note: "the bot crashed, press r to restart"
-	};
-	if (status.health === "down") return {
-		badge: "error",
-		note: "health check failed"
-	};
-	if (status.typecheck === "failed") return {
-		badge: "error",
-		note: "type check failed, press e to view it"
-	};
-	if (status.process === "stopped") return {
-		badge: "error",
-		note: "the bot stopped, press r to restart"
-	};
-	if (status.progress.fraction < 1) return {
-		badge: "starting",
-		note: status.progress.message
-	};
-	if (status.process === "running") return {
-		badge: "ready",
-		note: "watching for changes"
-	};
-	return {
-		badge: "starting",
-		note: "waiting for the first build"
-	};
-}
-/** Formats a duration the way a dev session reads it: `mm:ss` under an hour, `h:mm:ss` above. */
-function formatDuration(milliseconds) {
-	const total = Math.max(0, Math.floor(milliseconds / 1e3));
-	const seconds = total % 60;
-	const minutes = Math.floor(total / 60) % 60;
-	const hours = Math.floor(total / 3600);
-	const pad = (value) => value.toString().padStart(2, "0");
-	return hours > 0 ? `${hours}:${pad(minutes)}:${pad(seconds)}` : `${pad(minutes)}:${pad(seconds)}`;
-}
-
 //#endregion
 //#region src/dev/tui/ink/components/InfoOverlay.tsx
 function InfoOverlay({ service, height, width, onClose }) {
@@ -492,9 +1206,9 @@ function InfoOverlay({ service, height, width, onClose }) {
 function Panel({ status, config, counters, frame, elapsedMs, width, height, confirmQuit }) {
 	const paint = usePaint();
 	const state = describeBadge(status);
-	const busy = state.badge !== "ready" && state.badge !== "error";
+	const busy = isBusy(state.badge);
 	const badge = !busy && counters.errors > 0 ? "error" : state.badge;
-	const note = badge === "error" && state.badge === "ready" ? "an error was logged · press e to view it" : state.note;
+	const note = status.prompt ? "commands updated · press y to refresh them, n to skip" : badge === "error" && state.badge === "ready" ? "an error was logged · press e to view it" : state.note;
 	const filled = Math.round(Math.min(1, Math.max(0, status.progress.fraction)) * 20);
 	let shown = [
 		...(config.dev.banner === false ? [] : config.dev.banner?.flatMap((line) => line.split("\n")) ?? [null]).slice(0, 4).map((line, index) => ({
@@ -636,7 +1350,7 @@ function Panel({ status, config, counters, frame, elapsedMs, width, height, conf
 					" ",
 					/* @__PURE__ */ jsx(Text, {
 						bold: true,
-						backgroundColor: paint(confirmQuit || busy ? "busy" : badge === "error" ? "error" : "success"),
+						backgroundColor: paint(confirmQuit || busy || badge === "stopped" ? "busy" : badge === "error" ? "error" : "success"),
 						color: paint(badge === "error" && !confirmQuit ? "onError" : "onBright"),
 						children: ` ${confirmQuit ? "QUIT?" : badge === "restarting" ? "RESTART" : badge.toUpperCase()} `
 					}),
@@ -855,44 +1569,79 @@ function ThemeOverlay({ current, height, width, onPreview, onSelect, onClose })
 
 //#endregion
 //#region src/dev/tui/ink/DevApp.tsx
+/** The dashboard needs room for its sidebar next to a readable log line, and for more than a handful of entries. */
+const DASHBOARD_MIN_COLUMNS = 90;
+const DASHBOARD_MIN_ROWS = 20;
+/** Below this even an explicit `dashboard` falls back to the panel: the sidebar alone would fill the terminal. */
+const DASHBOARD_HARD_MIN_COLUMNS = 60;
+const DASHBOARD_HARD_MIN_ROWS = 10;
+/** The layout to paint for a terminal size: what was asked for when it fits, the panel otherwise. */
+function resolveLayout(layout, columns, rows) {
+	if (layout === "panel") return "panel";
+	if (columns < DASHBOARD_HARD_MIN_COLUMNS || rows < DASHBOARD_HARD_MIN_ROWS) return "panel";
+	if (layout === "dashboard") return "dashboard";
+	return columns >= 90 && rows >= 20 ? "dashboard" : "panel";
+}
 /**
-* A bottom-aligned panel in the normal buffer, with logs folded away. Only the browsable overlays use the
-* alternate screen, preserving the terminal's history and the panel when they close.
+* Two layouts over one service. The dashboard is a full-screen view in the alternate buffer; the panel is pinned to
+* the bottom of the normal buffer with the logs folded away, and is what a small terminal gets. The browsable
+* overlays use the alternate buffer from either, preserving the terminal's history and the panel when they close.
 */
-function DevApp({ service, color, theme, reducedMotion, onQuit, onViewChange, onCopy, onThemeSave }) {
+function DevApp({ service, color, theme, reducedMotion, layout = "auto", filter, onQuit, onViewChange, onCopy, onThemeSave }) {
 	const { columns, rows } = useWindowSize();
-	const [view, setView] = useState("panel");
+	const [overlay, setOverlay] = useState(null);
+	const [chosen, setChosen] = useState(layout);
 	const [confirmQuit, setConfirmQuit] = useState(false);
+	const [captured, setCaptured] = useState(false);
+	const [, repaint] = useState(0);
 	const [saved, setSaved] = useState(theme);
 	const [preview, setPreview] = useState(theme);
+	const [initialFilter] = useState(() => filter ?? initialLogView(service.config));
 	const status = useDevStatus(service);
 	const counters = useLogCounters(service);
 	const badge = describeBadge(status).badge;
-	const busy = badge !== "ready" && badge !== "error";
-	const clock = useBuildClock(status.progress.startedAt, busy && view === "panel", reducedMotion);
+	const busy = isBusy(badge);
+	const base = resolveLayout(chosen, columns, rows);
+	const clock = useBuildClock(status.progress.startedAt, busy && overlay === null, reducedMotion);
 	const width = Math.max(1, columns);
 	const height = Math.max(2, rows - 1);
-	const changeView = (next) => {
-		onViewChange(next !== "panel");
-		setView(next);
+	const fullScreen = overlay !== null || base === "dashboard";
+	const shown = useRef(fullScreen);
+	const show = (nextOverlay, nextChosen = chosen) => {
+		const next = nextOverlay !== null || resolveLayout(nextChosen, columns, rows) === "dashboard";
+		shown.current = next;
+		onViewChange(next);
+		setOverlay(nextOverlay);
+		setChosen(nextChosen);
 	};
+	useEffect(() => {
+		if (shown.current === fullScreen) return;
+		shown.current = fullScreen;
+		onViewChange(fullScreen);
+		repaint((count) => count + 1);
+	}, [fullScreen, onViewChange]);
+	const onCapture = useCallback((capturing) => setCaptured(capturing), []);
 	useInput((input, key) => {
 		if (key.ctrl && input === "c") return onQuit();
 		if (key.ctrl && input === "l") return service.clearLogs();
-		if (view !== "panel") return;
+		if (overlay !== null || captured) return;
 		if (confirmQuit) {
 			if (input === "y") return onQuit();
 			return setConfirmQuit(false);
 		}
 		if (key.ctrl && input === "r") return void service.restart("manual");
 		if (key.ctrl && input === "d") return busy ? setConfirmQuit(true) : onQuit();
+		if (status.prompt && (input === "y" || input === "n")) return service.answerPrompt(input === "y");
 		switch (input) {
 			case "q": return busy ? setConfirmQuit(true) : onQuit();
 			case "r":
 				service.restart("manual");
 				return;
-			case "l": return changeView("logs");
-			case "e": return changeView("errors");
+			case "d":
+				service.disconnect();
+				return;
+			case "l": return show("logs");
+			case "e": return base === "panel" ? show("errors") : void 0;
 			case "c": return service.clearLogs();
 			case "o":
 				openDevUrl(status.url).catch((error) => service.log("stars", "warn", error.message));
@@ -900,10 +1649,11 @@ function DevApp({ service, color, theme, reducedMotion, onQuit, onViewChange, on
 			case "t":
 				service.toggleTunnel();
 				return;
-			case "i": return changeView("info");
-			case "T": return changeView("theme");
+			case "i": return show("info");
+			case "T": return show("theme");
+			case "v": return show(null, base === "dashboard" ? "panel" : "dashboard");
 			case "h":
-			case "?": return changeView("help");
+			case "?": return show("help");
 		}
 	});
 	return /* @__PURE__ */ jsx(ThemeProvider, {
@@ -913,28 +1663,28 @@ function DevApp({ service, color, theme, reducedMotion, onQuit, onViewChange, on
 			width,
 			height,
 			flexDirection: "column",
-			justifyContent: view === "panel" ? "flex-end" : "flex-start",
+			justifyContent: fullScreen ? "flex-start" : "flex-end",
 			children: [
-				(view === "logs" || view === "errors") && /* @__PURE__ */ jsx(LogBrowser, {
+				(overlay === "logs" || overlay === "errors") && /* @__PURE__ */ jsx(LogBrowser, {
 					service,
 					height,
 					width,
-					lastError: view === "errors",
+					lastError: overlay === "errors",
 					onCopy,
-					onClose: () => changeView("panel")
+					onClose: () => show(null)
 				}),
-				view === "help" && /* @__PURE__ */ jsx(HelpOverlay, {
+				overlay === "help" && /* @__PURE__ */ jsx(HelpOverlay, {
 					height,
 					width,
-					onClose: () => changeView("panel")
+					onClose: () => show(null)
 				}),
-				view === "info" && /* @__PURE__ */ jsx(InfoOverlay, {
+				overlay === "info" && /* @__PURE__ */ jsx(InfoOverlay, {
 					service,
 					height,
 					width,
-					onClose: () => changeView("panel")
+					onClose: () => show(null)
 				}),
-				view === "theme" && /* @__PURE__ */ jsx(ThemeOverlay, {
+				overlay === "theme" && /* @__PURE__ */ jsx(ThemeOverlay, {
 					current: saved,
 					height,
 					width,
@@ -943,14 +1693,29 @@ function DevApp({ service, color, theme, reducedMotion, onQuit, onViewChange, on
 						setSaved(setting);
 						setPreview(setting);
 						onThemeSave(setting);
-						changeView("panel");
+						show(null);
 					},
 					onClose: () => {
 						setPreview(saved);
-						changeView("panel");
+						show(null);
 					}
 				}),
-				view === "panel" && /* @__PURE__ */ jsx(Panel, {
+				base === "dashboard" && /* @__PURE__ */ jsx(Box, {
+					display: overlay === null ? "flex" : "none",
+					children: /* @__PURE__ */ jsx(Dashboard, {
+						service,
+						status,
+						counters,
+						...clock,
+						width,
+						height,
+						confirmQuit,
+						initialFilter,
+						active: overlay === null,
+						onCapture
+					})
+				}),
+				base === "panel" && overlay === null && /* @__PURE__ */ jsx(Panel, {
 					status,
 					config: service.config,
 					counters,
@@ -998,8 +1763,9 @@ function captureOutput(service, stream, fallback) {
 //#endregion
 //#region src/dev/tui/tui.tsx
 /**
-* A normal-buffer, bottom-aligned panel and alternate-buffer overlays. External output is captured for the log
-* browser; the renderer alone writes to the terminal. Switching views and teardown restore the original buffer.
+* The full-screen dashboard and the overlays in the alternate buffer, the bottom-aligned panel in the normal one.
+* External output is captured for the log views; the renderer alone writes to the terminal. Switching views and
+* teardown restore the original buffer.
 *
 * `start()` resolves when the user quits, which is what `stars dev` waits on before shutting the bot down.
 */
@@ -1013,14 +1779,17 @@ function createTuiRenderer(service, options = {}) {
 		return typeof value === "function" ? value.bind(target) : value;
 	} });
 	const restoreOutput = stdout === process.stdout ? [captureOutput(service, process.stdout, "info"), captureOutput(service, process.stderr, "warn")] : [];
-	let alternate = false;
+	const layout = options.layout ?? service.config.dev.layout ?? "auto";
+	let alternate = resolveLayout(layout, stdout.columns ?? 80, stdout.rows ?? 24) === "dashboard";
+	if (alternate) write("\x1B[?1049h\x1B[H");
 	let stopped = false;
-	const switchView = (overlay) => {
-		if (overlay === alternate || stopped) return;
+	const switchView = (fullScreen) => {
+		if (fullScreen === alternate || stopped) return;
 		instance.clear();
-		write(overlay ? "\x1B[?1049h\x1B[H" : "\x1B[?1049l");
-		alternate = overlay;
+		write(fullScreen ? "\x1B[?1049h\x1B[H" : "\x1B[?1049l");
+		alternate = fullScreen;
 	};
+	service.promptable = true;
 	let quit;
 	const quitting = new Promise((resolve) => {
 		quit = resolve;
@@ -1031,6 +1800,8 @@ function createTuiRenderer(service, options = {}) {
 		theme: options.theme ?? "auto",
 		onThemeSave: options.onThemeSave ?? (() => {}),
 		reducedMotion: options.reducedMotion ?? false,
+		layout,
+		filter: options.filter,
 		onQuit: quit,
 		onViewChange: switchView,
 		onCopy: (text) => write(`\u001B]52;c;${Buffer.from(text.slice(0, 65536)).toString("base64")}\u0007`)
@@ -1049,6 +1820,7 @@ function createTuiRenderer(service, options = {}) {
 		stop() {
 			if (stopped) return;
 			stopped = true;
+			service.promptable = false;
 			if (alternate) instance.clear();
 			instance.unmount();
 			if (alternate) write("\x1B[?1049l");
@@ -1065,4 +1837,4 @@ function createTuiRenderer(service, options = {}) {
 
 //#endregion
 export { createTuiRenderer };
-//# sourceMappingURL=tui-BRddrLQP.js.map
+//# sourceMappingURL=tui-nldGSD4c.js.map