@forgeax/interface 0.4.1

package/dist/package/node/components/StatusBar/InfoPanel.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * InfoPanel — a Blender-INFO-editor-style log panel.
+ *
+ * Registered as the footer-merged bottom-edge 'info' panel (ADR-0030 §2.3, see
+ * core/extensions/chrome-drawer.tsx): its footer tab expands it upward. Content
+ * is the full health feed with the affordances Blender's INFO editor has:
+ *
+ *   - one row per entry: severity icon + time + source badge + message, newest
+ *     at the bottom, auto-scrolled to the latest;
+ *   - CLICK A ROW to copy its full text (source · time · message) to the
+ *     clipboard, with a brief "copied" flash;
+ *   - consecutive identical entries fold into ONE row + an `×N` count badge so a
+ *     flood (e.g. `PickError ... has no Camera component`) occupies one line;
+ *   - severity / source filters + a copy-all + clear button.
+ *
+ * Pure presentation over healthStore — no engine coupling.
+ */
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { createRestartableTimeoutTaskLifecycle } from '@forgeax/app-shell/react';
+import { Info, CheckCircle2, AlertTriangle, XCircle, Trash2, Copy, Check } from 'lucide-react';
+import { useTranslation } from '../../i18n/index.js';
+import { useHealthStore, collapseEntries, entryToText, } from './healthStore.js';
+
+const ICONS = {
+    info: Info,
+    success: CheckCircle2,
+    warn: AlertTriangle,
+    error: XCircle,
+};
+const LEVELS = ['info', 'success', 'warn', 'error'];
+const SOURCES = ['play', 'edit', 'plugin', 'shell', 'engine'];
+function fmtTime(ts) {
+    const d = new Date(ts);
+    const p = (n) => String(n).padStart(2, '0');
+    return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
+}
+function CopyRow({ ce, latest, onCopy, copied, }) {
+    const { t } = useTranslation();
+    const { entry, count } = ce;
+    const Icon = ICONS[entry.level];
+    return (_jsxs("div", { className: `ip-row ip-row--${entry.level}${latest ? ' ip-row--latest' : ''}${copied ? ' ip-row--copied' : ''}`, "data-code": entry.code, role: "button", tabIndex: 0, title: t('infoPanel.clickToCopy'), onClick: () => onCopy(ce), onKeyDown: (e) => {
+            if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault();
+                onCopy(ce);
+            }
+        }, children: [_jsx(Icon, { className: "ip-icon", size: 13 }), _jsx("span", { className: "ip-time", children: fmtTime(entry.ts) }), _jsx("span", { className: `ip-source ip-source--${entry.source}`, children: entry.source }), _jsx("span", { className: "ip-msg", children: entry.message }), count > 1 && _jsxs("span", { className: "ip-count", title: t('infoPanel.repeatedTimes', { count }), children: ["\u00D7", count] }), _jsx("span", { className: "ip-copy-hint", children: copied ? _jsx(Check, { size: 12 }) : _jsx(Copy, { size: 12 }) })] }));
+}
+export function InfoPanel() {
+    const { t } = useTranslation();
+    const entries = useHealthStore((s) => s.entries);
+    const clear = useHealthStore((s) => s.clear);
+    const listRef = useRef(null);
+    // key of the row most recently copied → flashes a "copied" state briefly.
+    const [copiedKey, setCopiedKey] = useState(null);
+    const [allCopied, setAllCopied] = useState(false);
+    const rowCopyResetTaskRef = useRef(null);
+    const allCopyResetTaskRef = useRef(null);
+    useEffect(() => {
+        const rowTask = createRestartableTimeoutTaskLifecycle({
+            delayMs: 900,
+            task: () => setCopiedKey(null),
+        });
+        const allTask = createRestartableTimeoutTaskLifecycle({
+            delayMs: 900,
+            task: () => setAllCopied(false),
+        });
+        rowCopyResetTaskRef.current = rowTask;
+        allCopyResetTaskRef.current = allTask;
+        return () => {
+            rowCopyResetTaskRef.current = null;
+            allCopyResetTaskRef.current = null;
+            rowTask.dispose();
+            allTask.dispose();
+        };
+    }, []);
+    // Severity / source filters. null entries mean "show all of that axis".
+    const [levelFilter, setLevelFilter] = useState(new Set());
+    const [sourceFilter, setSourceFilter] = useState(new Set());
+    const filtered = useMemo(() => {
+        if (levelFilter.size === 0 && sourceFilter.size === 0)
+            return entries;
+        return entries.filter((e) => (levelFilter.size === 0 || levelFilter.has(e.level)) &&
+            (sourceFilter.size === 0 || sourceFilter.has(e.source)));
+    }, [entries, levelFilter, sourceFilter]);
+    // Fold consecutive identical entries into ×N rows.
+    const collapsed = useMemo(() => collapseEntries(filtered), [filtered]);
+    // Auto-scroll to newest whenever the visible set grows.
+    useEffect(() => {
+        if (listRef.current)
+            listRef.current.scrollTop = listRef.current.scrollHeight;
+    }, [collapsed.length, entries.length]);
+    const copyText = (text) => {
+        try {
+            void navigator.clipboard?.writeText(text);
+        }
+        catch {
+            /* clipboard may be unavailable (insecure ctx) — fail silently */
+        }
+    };
+    const handleCopyRow = (ce) => {
+        copyText(entryToText(ce.entry, ce.count));
+        setCopiedKey(ce.key);
+        rowCopyResetTaskRef.current?.schedule();
+    };
+    const handleCopyAll = () => {
+        const text = collapsed.map((ce) => entryToText(ce.entry, ce.count)).join('\n');
+        copyText(text);
+        setAllCopied(true);
+        allCopyResetTaskRef.current?.schedule();
+    };
+    const toggleLevel = (l) => setLevelFilter((s) => {
+        const n = new Set(s);
+        n.has(l) ? n.delete(l) : n.add(l);
+        return n;
+    });
+    const toggleSource = (src) => setSourceFilter((s) => {
+        const n = new Set(s);
+        n.has(src) ? n.delete(src) : n.add(src);
+        return n;
+    });
+    return (_jsxs("div", { className: "info-panel", children: [_jsxs("div", { className: "ip-toolbar", children: [_jsxs("div", { className: "ip-filters", children: [LEVELS.map((l) => {
+                                const Icon = ICONS[l];
+                                return (_jsx("button", { type: "button", className: `ip-filter ip-filter--${l}${levelFilter.has(l) ? ' on' : ''}`, title: t('infoPanel.filterLevel', { level: l }), onClick: () => toggleLevel(l), children: _jsx(Icon, { size: 12 }) }, l));
+                            }), _jsx("span", { className: "ip-filter-sep" }), SOURCES.map((src) => (_jsx("button", { type: "button", className: `ip-filter ip-filter--src ip-source--${src}${sourceFilter.has(src) ? ' on' : ''}`, title: t('infoPanel.filterSource', { source: src }), onClick: () => toggleSource(src), children: src }, src)))] }), _jsx("span", { className: "ip-spacer" }), _jsxs("button", { type: "button", className: "ip-tb-btn", title: t('infoPanel.copyAll'), onClick: handleCopyAll, disabled: collapsed.length === 0, children: [allCopied ? _jsx(Check, { size: 13 }) : _jsx(Copy, { size: 13 }), " ", t('infoPanel.copyAll')] }), _jsxs("button", { type: "button", className: "ip-tb-btn", title: t('infoPanel.clear'), onClick: () => clear(), disabled: entries.length === 0, children: [_jsx(Trash2, { size: 13 }), " ", t('infoPanel.clear')] })] }), _jsxs("div", { className: "ip-list thin-scrollbar", ref: listRef, role: "log", "aria-live": "polite", "aria-label": "forgeax INFO log", children: [collapsed.length === 0 && (_jsx("div", { className: "ip-empty", children: entries.length === 0
+                            ? t('infoPanel.emptyNoMessages')
+                            : t('infoPanel.emptyNoMatch') })), collapsed.map((ce, i) => (_jsx(CopyRow, { ce: ce, latest: i === collapsed.length - 1, onCopy: handleCopyRow, copied: copiedKey === ce.key }, ce.key)))] })] }));
+}

package/dist/package/node/components/StatusBar/StatusChip.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+
+export function StatusChip({ tone, state = 'ok', icon: Icon, label, value, title, onClick, flashKey = 0, ariaLabel, }) {
+    const className = [
+        'sb-chip',
+        onClick ? 'is-link' : '',
+    ].filter(Boolean).join(' ');
+    const inner = (_jsxs(_Fragment, { children: [_jsx("span", { className: "sb-chip-label", children: label }), _jsx("span", { className: "sb-chip-value", children: value })] }));
+    if (onClick) {
+        return (_jsx("button", { type: "button", className: className, title: title, onClick: onClick, "aria-label": ariaLabel ?? `${label} ${value}`, children: inner }));
+    }
+    return (_jsx("div", { className: className, title: title, role: "status", "aria-label": ariaLabel ?? `${label} ${value}`, children: inner }));
+}

package/dist/package/node/components/StatusBar/StripHostView.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * StripHostView — the footer host view for `kind:'strip'` locations
+ * (ADR-0030 §2.3). Renders StatusItemContributions from the SINGLE derived
+ * panels snapshot (host.panels.stripItems) instead of the retired module-level
+ * statusBarStore, so every footer chip flows through the one contribution
+ * channel with owner-tagged, reversible lifecycle.
+ *
+ *   ┌────────────────────────────────────────────────────────────────────┐
+ *   │ CB · Info · …            │ Ready · MB · … · Diagnostics · version │
+ *   └────────────────────────────────────────────────────────────────────┘
+ *     bottom dock tabs                    center · right · left (visual order)
+ *
+ * Each slot has a VISIBLE_PER_SLOT capacity. On overflow the trailing visible
+ * position rotates through the low-priority surplus every CAROUSEL_INTERVAL_MS
+ * (a deterministic rotating window — no re-mount, no state loss), preserving
+ * the legacy GlobalStatusBar behavior.
+ *
+ * Item bodies (ADR-0030 §2.2):
+ *   - text   → static label + tooltip
+ *   - button → command-driven button (host.commands.execute)
+ *   - custom → in-process live chip (owns its own subscriptions)
+ */
+import { useEffect, useMemo, useState } from 'react';
+import { createIntervalTaskLifecycle } from '@forgeax/app-shell/react';
+import { icons as LucideIcons } from 'lucide-react';
+import { usePanelRenderers } from '../DockShell/panelRenderers.js';
+import { useHost } from '../../core/app-shell/index.js';
+
+/** Mirrors GlobalStatusBar.css and makes the real consumer's visual order
+ * inspectable in DOM evidence without treating a slot name as geometry. */
+const VISUAL_ORDER = { left: 4, center: 2, right: 3 };
+const SLOT_OF = {
+    'statusbar.left': 'left',
+    'statusbar.center': 'center',
+    'statusbar.right': 'right',
+};
+const VISIBLE_PER_SLOT = { left: 4, center: 2, right: 6 };
+const CAROUSEL_INTERVAL_MS = 4000;
+export function StripHostView() {
+    const renderers = usePanelRenderers();
+    const [tick, setTick] = useState(0);
+    useEffect(() => {
+        const carousel = createIntervalTaskLifecycle({
+            intervalMs: CAROUSEL_INTERVAL_MS,
+            task: () => setTick((x) => x + 1),
+        });
+        carousel.start();
+        return () => carousel.dispose();
+    }, []);
+    const bySlot = useMemo(() => {
+        const out = { left: [], center: [], right: [] };
+        const items = Object.values(renderers.stripItems ?? {});
+        for (const it of items) {
+            if (it.when && !it.when())
+                continue;
+            out[SLOT_OF[it.location]].push(it);
+        }
+        for (const slot of Object.keys(out)) {
+            out[slot].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+        }
+        return out;
+    }, [renderers.stripItems]);
+    return (_jsxs("div", { className: "global-status-bar", role: "status", "aria-live": "polite", "aria-label": "forgeax status bar", "data-fx-slot": "StatusBar", "data-tour-id": "footer", children: [_jsx("div", { className: "sb-slot sb-slot-dock", "data-fx-dock-bottom-host": true, "aria-hidden": "true" }), _jsx(Slot, { slot: "left", items: bySlot.left, tick: tick }), _jsx(Slot, { slot: "center", items: bySlot.center, tick: tick }), _jsx(Slot, { slot: "right", items: bySlot.right, tick: tick })] }));
+}
+function Slot({ slot, items, tick }) {
+    const cap = VISIBLE_PER_SLOT[slot];
+    const isOverflow = items.length > cap;
+    const visible = useMemo(() => {
+        if (!isOverflow)
+            return items;
+        const anchored = items.slice(0, cap - 1);
+        const rotatingPool = items.slice(cap - 1);
+        const rotated = rotatingPool[tick % rotatingPool.length];
+        return [...anchored, rotated];
+    }, [items, isOverflow, cap, tick]);
+    const hiddenCount = isOverflow ? items.length - cap : 0;
+    return (_jsxs("div", { className: `sb-slot sb-slot-${slot}`, "data-slot-count": items.length, "data-slot-visible": visible.length, "data-slot-order": VISUAL_ORDER[slot], children: [visible.map((it) => (_jsx("div", { className: "sb-item", "data-item-id": it.id, children: _jsx(StatusItemView, { item: it }) }, it.id))), hiddenCount > 0 && (_jsxs("span", { className: "sb-overflow", title: `${hiddenCount} more chip(s) cycling every ${CAROUSEL_INTERVAL_MS / 1000}s · low priority items rotate through the last visible slot`, "aria-label": `${hiddenCount} hidden status items, rotating`, children: ["+", hiddenCount, "\u21BB"] }))] }));
+}
+function StatusItemView({ item }) {
+    const host = useHost();
+    const body = item.item;
+    if (body.type === 'custom')
+        return body.render();
+    if (body.type === 'text') {
+        return (_jsx("span", { className: "sb-chip", title: body.tooltip, children: body.text }));
+    }
+    // button
+    const Icon = body.icon ? LucideIcons[body.icon] : undefined;
+    return (_jsxs("button", { type: "button", className: "sb-chip is-button", title: body.tooltip, onClick: () => { void host.commands.execute(body.command, body.args); }, children: [Icon ? _jsx(Icon, { size: 12, className: "sb-chip-icon" }) : null, body.label ? _jsx("span", { className: "sb-chip-label", children: body.label }) : null] }));
+}

package/dist/package/node/components/StatusBar/StripPopover.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Business-agnostic status-bar popover shell.
+ *
+ * The shell owns only the trigger, Radix portal/content, focus handling, and
+ * the header slots. Callers provide the label, title, and body; no product or
+ * Host dependency belongs here.
+ */
+import * as Popover from '@radix-ui/react-popover';
+import { icons as LucideIcons } from 'lucide-react';
+
+export function StripPopover({ icon, label, title, tooltip, headerAction, children, }) {
+    const Icon = icon ? LucideIcons[icon] : undefined;
+    return (_jsxs(Popover.Root, { children: [_jsx(Popover.Trigger, { asChild: true, children: _jsxs("button", { type: "button", className: "sb-chip is-button fx-strip-pop-btn", title: tooltip, "aria-label": typeof label === 'string' ? label : tooltip, children: [Icon ? _jsx(Icon, { size: 12, className: "sb-chip-icon" }) : null, label != null ? _jsx("span", { className: "sb-chip-label", children: label }) : null] }) }), _jsx(Popover.Portal, { children: _jsxs(Popover.Content, { className: "fx-strip-pop", side: "top", align: "center", sideOffset: 6, collisionPadding: 8, onOpenAutoFocus: (event) => event.preventDefault(), children: [_jsxs("div", { className: "fx-strip-pop-h", children: [title, headerAction ? _jsx("span", { className: "fx-strip-pop-h-act", children: headerAction }) : null] }), children] }) })] }));
+}

package/dist/package/node/components/StatusBar/feeds/PulseFeeds.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Bus-kind pulse chips — the live MB / SKILL / TOOL / AGENT extension-registry
+ * counters (originally PreviewMode's pt-right toolbar, moved to the global
+ * status bar 2026-05-17). The former RES (system resource) chip was folded into
+ * the diagnostics popover, since server mem/uptime/WS is environment-diagnostic
+ * data, not a bus-kind count.
+ *
+ * Each `*Feed` polls its source, then renders a `<StatusChip>`. The visual
+ * primitive is shared so the strip reads as a coherent unit; only the `tone`
+ * color changes between kinds (teal/gold/orange/violet).
+ */
+import { Brain, Sparkles, Wrench, Bot } from 'lucide-react';
+import { useTranslation } from '../../../i18n/index.js';
+import { useShellStore } from '../../../store.js';
+import { emitDeepLink } from '../../../lib/deep-link-bus.js';
+import { useSharedExtensionCounts } from '../../../lib/shell-live-data.js';
+import { StatusChip } from '../StatusChip.js';
+/** ADR-0030 §2.2 — the live MB/SKILL/TOOL/AGENT pulse chips as `custom`
+ *  status-item contributions. Each chip owns its own polling (the in-process
+ *  escape hatch); chrome-statusbar folds these into the footer's strip channel. */
+export const pulseStatusItems = [
+    { kind: 'status-item', id: 'bus.mb', location: 'statusbar.right', priority: 90, item: { type: 'custom', render: () => _jsx(ModelBindingPulseFeed, {}) } },
+    { kind: 'status-item', id: 'bus.skill', location: 'statusbar.right', priority: 50, item: { type: 'custom', render: () => _jsx(SkillPulseFeed, {}) } },
+    { kind: 'status-item', id: 'bus.tool', location: 'statusbar.right', priority: 45, item: { type: 'custom', render: () => _jsx(ToolPulseFeed, {}) } },
+    { kind: 'status-item', id: 'bus.agent', location: 'statusbar.right', priority: 40, item: { type: 'custom', render: () => _jsx(AgentPulseFeed, {}) } },
+];
+function usePulseKind(kind) {
+    const snapshot = useSharedExtensionCounts();
+    if (snapshot.state === 'loading')
+        return { state: 'loading', count: 0, ids: [] };
+    if (snapshot.state === 'down')
+        return { state: 'down', count: 0, ids: [] };
+    const row = snapshot.value[kind];
+    return { state: row.count > 0 ? 'ok' : 'empty', count: row.count, ids: row.ids };
+}
+// ─── MB · model-binding kind count ────────────────────────────────────────
+function ModelBindingPulseFeed() {
+    const { t } = useTranslation();
+    const openOverlay = useShellStore((s) => s.openOverlay);
+    const { state, count, ids } = usePulseKind('model-binding');
+    const value = state === 'loading' ? '—' : state === 'down' ? '!' : count.toString();
+    const title = state === 'ok' || state === 'empty'
+        ? count > 0
+            ? t('pulse.mb.title.some', { count: String(count) }) + '\n' + ids.map((id) => `· ${id}`).join('\n')
+            : t('pulse.mb.title.none')
+        : state === 'down' ? t('pulse.mb.title.down') : t('pulse.mb.title.loading');
+    return (_jsx(StatusChip, { tone: "teal", state: state, icon: Brain, label: "MB", value: value, title: title, onClick: () => { openOverlay('settings', 'plugins'); emitDeepLink('bus:filter-kind', 'model-binding'); } }));
+}
+// ─── SKILL ────────────────────────────────────────────────────────────────
+function SkillPulseFeed() {
+    const { t } = useTranslation();
+    const openOverlay = useShellStore((s) => s.openOverlay);
+    const { state, count, ids } = usePulseKind('skill');
+    const value = state === 'loading' ? '—' : state === 'down' ? '!' : count.toString();
+    const title = state === 'ok' || state === 'empty'
+        ? count > 0
+            ? t('pulse.skill.title.some', { count: String(count) }) + '\n' + ids.map((id) => `· ${id}`).join('\n')
+            : t('pulse.skill.title.none')
+        : state === 'down' ? t('pulse.skill.title.down') : t('pulse.skill.title.loading');
+    return (_jsx(StatusChip, { tone: "gold", state: state, icon: Sparkles, label: "SKILL", value: value, title: title, onClick: () => { openOverlay('settings', 'plugins'); emitDeepLink('bus:filter-kind', 'skill'); } }));
+}
+// ─── TOOL ─────────────────────────────────────────────────────────────────
+function ToolPulseFeed() {
+    const { t } = useTranslation();
+    const openOverlay = useShellStore((s) => s.openOverlay);
+    const { state, count, ids } = usePulseKind('tool');
+    const value = state === 'loading' ? '—' : state === 'down' ? '!' : count.toString();
+    const title = state === 'ok' || state === 'empty'
+        ? count > 0
+            ? t('pulse.tool.title.some', { count: String(count) }) + '\n' + ids.map((id) => `· ${id}`).join('\n')
+            : t('pulse.tool.title.none')
+        : state === 'down' ? t('pulse.tool.title.down') : t('pulse.tool.title.loading');
+    return (_jsx(StatusChip, { tone: "orange", state: state, icon: Wrench, label: "TOOL", value: value, title: title, onClick: () => { openOverlay('settings', 'plugins'); emitDeepLink('bus:filter-kind', 'tool'); } }));
+}
+// ─── AGENT ────────────────────────────────────────────────────────────────
+function AgentPulseFeed() {
+    const { t } = useTranslation();
+    const openOverlay = useShellStore((s) => s.openOverlay);
+    const { state, count, ids } = usePulseKind('agent');
+    const value = state === 'loading' ? '—' : state === 'down' ? '!' : count.toString();
+    const title = state === 'ok' || state === 'empty'
+        ? count > 0
+            ? t('pulse.agent.title.some', { count: String(count) }) + '\n' + ids.map((id) => `· ${id}`).join('\n')
+            : t('pulse.agent.title.none')
+        : state === 'down' ? t('pulse.agent.title.down') : t('pulse.agent.title.loading');
+    return (_jsx(StatusChip, { tone: "violet", state: state, icon: Bot, label: "AGENT", value: value, title: title, onClick: () => { openOverlay('settings', 'plugins'); emitDeepLink('bus:filter-kind', 'agent'); } }));
+}

package/dist/package/node/components/StatusBar/footer/CheckpointsDrawer.js

@@ -0,0 +1,77 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * CheckpointsDrawer — the "检查点" bottom-drawer panel (demo `data-rt=
+ * "checkpoints"`). A timeline of the active session's rewind checkpoints, newest
+ * at the top, with the current HEAD highlighted.
+ *
+ * REAL data: session-level rewind anchors via checkpoint-api
+ * (GET /api/sessions/:sid/checkpoints). Each user message snapshots the game dir
+ * (CheckpointManager); `hasCode=false` means a pure-conversation turn. The list
+ * has no commit-message text (only msgId), so rows show a code/conversation
+ * label + short id + time. A `drawer` panel (ADR-0030 §2.3), contributed by
+ * chrome-drawer.tsx next to Info.
+ */
+import { useEffect, useState } from 'react';
+import { createSettledPollingLifecycle } from '@forgeax/app-shell/react';
+import { useShellStore } from '../../../store.js';
+import { fetchCheckpoints } from '../../../lib/checkpoint-api.js';
+
+/** epoch ms → "HH:MM:SS". */
+function fmtTime(ms) {
+    const d = new Date(ms);
+    return d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: false });
+}
+export function CheckpointsDrawer() {
+    const activeSid = useShellStore((s) => s.activeSid);
+    const [items, setItems] = useState([]);
+    const [pending, setPending] = useState(null);
+    useEffect(() => {
+        if (!activeSid) {
+            setItems([]);
+            setPending(null);
+            return;
+        }
+        const poll = createSettledPollingLifecycle({
+            task: async (signal) => {
+                try {
+                    const { checkpoints, pending: p } = await fetchCheckpoints(activeSid, signal);
+                    setItems(checkpoints);
+                    setPending(p);
+                }
+                catch {
+                    if (signal.aborted)
+                        throw new Error('checkpoint request timed out');
+                    setItems([]);
+                    setPending(null);
+                    throw new Error('checkpoint request failed');
+                }
+            },
+            intervalMs: 5_000,
+            timeoutMs: 5_000,
+        });
+        poll.start();
+        return poll.dispose;
+    }, [activeSid]);
+    if (items.length === 0) {
+        return _jsx("div", { className: "fx-drawer-content", children: _jsx("div", { className: "fx-empty", children: activeSid ? '暂无检查点' : '未连接会话' }) });
+    }
+    // API order is chronological (oldest first); show newest at the top. The
+    // current HEAD is the pending rewind target if any, else the latest anchor.
+    const total = items.length;
+    const headMsgId = pending?.targetMsgId ?? items[total - 1]?.msgId;
+    return (_jsx("div", { className: "fx-drawer-content", children: items
+            .map((c, i) => ({ c, n: i + 1 }))
+            .reverse()
+            .map(({ c, n }) => {
+            const head = c.msgId === headMsgId;
+            return (_jsxs("div", { className: `fx-ck${head ? ' head' : ''}`, children: [_jsx("div", { className: "dot" }), _jsxs("div", { children: [_jsx("div", { className: "ck-msg", children: c.hasCode ? '代码 + 会话快照' : '会话快照' }), _jsxs("div", { className: "ck-meta", children: [`#${n}`, " \u00B7 ", c.msgId.slice(0, 8), " \u00B7 ", fmtTime(c.ts), head ? (_jsxs(_Fragment, { children: [' · ', _jsx("span", { className: "cur", children: "\u5F53\u524D HEAD" })] })) : null] })] })] }, c.msgId));
+        }) }));
+}
+export const checkpointsDrawerPanel = {
+    id: 'checkpoints',
+    title: 'Checkpoints',
+    titleKey: 'footerPanel.checkpoints',
+    icon: 'History',
+    order: 1,
+    render: () => _jsx(CheckpointsDrawer, {}),
+};

package/dist/package/node/components/StatusBar/footer/DiagnosticsPopover.js

@@ -0,0 +1,108 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * DiagnosticsPopover — the right-side footer entry (demo `data-sb-pop="diag"`).
+ * A status-bar chip that opens an upward card summarizing device / runtime /
+ * project environment info. Same demo layout; data swapped to real sources:
+ *
+ *  - Device/memory/GPU: browser probes (navigator.platform / hardwareConcurrency;
+ *    performance.memory JS heap for the meter; WebGPU adapter info for GPU).
+ *  - Runtime: server RSS / uptime / WS from dashApi.health() (5s).
+ *  - Project: engine / project / scene / assets from the editor-facts bus
+ *    (useEditorFacts). The scene value has no public transport source and shows "—".
+ *
+ * Lives in interface, auto-registered by chrome-statusbar; sits far-right.
+ */
+import { useEffect, useState } from 'react';
+import { Gauge, Circle } from 'lucide-react';
+import { StripPopover } from '../StripPopover.js';
+import { useSharedHealth } from '../../../lib/shell-live-data.js';
+import { useEditorFacts } from '../../../lib/editor-facts-bus.js';
+import { useTranslation } from '../../../i18n/index.js';
+
+/** Compact uptime: "2h13m" / "13m" / "<1m". */
+function fmtUptime(s) {
+    if (s < 60)
+        return '<1m';
+    const h = Math.floor(s / 3600);
+    const m = Math.floor((s % 3600) / 60);
+    return h > 0 ? `${h}h${m}m` : `${m}m`;
+}
+function deviceLabel(unknownDevice, coreUnit) {
+    const nav = navigator;
+    const cores = nav.hardwareConcurrency;
+    const plat = nav.platform || unknownDevice;
+    return cores ? `${plat} · ${cores} ${coreUnit}` : plat;
+}
+function readHeap() {
+    const m = performance.memory;
+    if (!m || !m.jsHeapSizeLimit)
+        return null;
+    return {
+        usedMB: Math.round(m.usedJSHeapSize / 1048576),
+        totalMB: Math.round(m.jsHeapSizeLimit / 1048576),
+    };
+}
+async function probeGpu(unavailable) {
+    try {
+        const gpu = navigator.gpu;
+        if (!gpu?.requestAdapter)
+            return unavailable;
+        const adapter = await gpu.requestAdapter();
+        if (!adapter)
+            return unavailable;
+        const info = adapter.info ??
+            (typeof adapter.requestAdapterInfo === 'function' ? await adapter.requestAdapterInfo() : undefined);
+        if (!info)
+            return 'WebGPU';
+        const parts = [info.vendor, info.architecture].filter((x) => typeof x === 'string' && x.length > 0);
+        return parts.length ? parts.join(' · ') : 'WebGPU';
+    }
+    catch {
+        return unavailable;
+    }
+}
+export function DiagnosticsChip() {
+    const facts = useEditorFacts();
+    const sharedHealth = useSharedHealth();
+    const { t, i18n } = useTranslation();
+    const [gpu, setGpu] = useState(() => t('statusBar.diagnostics.checking'));
+    const [heap, setHeap] = useState(null);
+    const [resState, setResState] = useState('loading');
+    const [res, setRes] = useState(null);
+    useEffect(() => {
+        let cancelled = false;
+        setGpu(t('statusBar.diagnostics.checking'));
+        void probeGpu(t('statusBar.diagnostics.webgpuUnavailable')).then((g) => {
+            if (!cancelled)
+                setGpu(g);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [i18n.language, t]);
+    useEffect(() => {
+        setHeap(readHeap());
+        if (sharedHealth.state === 'loading')
+            return;
+        if (sharedHealth.state === 'down') {
+            setResState('down');
+            return;
+        }
+        const h = sharedHealth.value;
+        const rss = typeof h.mem?.rss === 'number' ? h.mem.rss : 0;
+        setRes({ rssMB: Math.round(rss / 1048576), uptime: h.uptime ?? 0, ws: h.wsClients ?? 0 });
+        setResState('ok');
+    }, [sharedHealth]);
+    const memPct = heap && heap.totalMB ? Math.round((heap.usedMB / heap.totalMB) * 100) : 0;
+    const resText = (fmt) => resState === 'loading' ? '—' : resState === 'down' ? '!' : res ? fmt(res) : '—';
+    return (_jsxs(StripPopover, { icon: "Gauge", label: t('statusBar.diagnostics.title'), tooltip: t('statusBar.diagnostics.tooltip'), title: _jsxs(_Fragment, { children: [_jsx(Gauge, { size: 13 }), t('statusBar.diagnostics.title')] }), children: [_jsxs("div", { className: "fx-pop-sec", children: [_jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: t('statusBar.diagnostics.device') }), _jsx("b", { children: deviceLabel(t('statusBar.diagnostics.unknownDevice'), t('statusBar.diagnostics.cores')) })] }), _jsxs("div", { className: "fx-meter", children: [_jsxs("div", { className: "fx-meter-top", children: [_jsx("span", { children: t('statusBar.diagnostics.memory') }), _jsx("b", { children: heap ? `${heap.usedMB} / ${heap.totalMB} MB` : t('statusBar.diagnostics.unavailable') })] }), _jsx("div", { className: "fx-meter-bar", children: _jsx("i", { style: { width: `${memPct}%` } }) })] }), _jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: "GPU" }), _jsx("b", { children: gpu })] }), _jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: t('statusBar.diagnostics.engine') }), _jsxs("b", { className: facts ? 'ok' : undefined, children: [facts ? _jsx(Circle, { size: 12 }) : null, facts?.engine ?? '—'] })] })] }), _jsx("div", { className: "fx-pop-div" }), _jsxs("div", { className: "fx-pop-sec", children: [_jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: t('statusBar.diagnostics.processMemory') }), _jsx("b", { children: resText((r) => `${r.rssMB} MB`) })] }), _jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: t('statusBar.diagnostics.uptime') }), _jsx("b", { children: resText((r) => fmtUptime(r.uptime)) })] }), _jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: t('statusBar.diagnostics.wsConnections') }), _jsx("b", { children: resText((r) => String(r.ws)) })] })] }), _jsx("div", { className: "fx-pop-div" }), _jsxs("div", { className: "fx-pop-sec", children: [_jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: t('statusBar.diagnostics.project') }), _jsx("b", { children: facts?.project ?? '—' })] }), _jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: t('statusBar.diagnostics.scene') }), _jsx("b", { children: facts?.scene ?? '—' })] }), _jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: t('statusBar.diagnostics.assets') }), _jsx("b", { children: facts ? facts.assets : '—' })] })] })] }));
+}
+// Pulse chips and diagnostics share statusbar.right. Its lower priority keeps
+// diagnostics after MB / SKILL / TOOL / AGENT and immediately before Version.
+export const diagnosticsStatusItem = {
+    kind: 'status-item',
+    id: 'diagnostics',
+    location: 'statusbar.right',
+    priority: 5,
+    item: { type: 'custom', render: () => _jsx(DiagnosticsChip, {}) },
+};

package/dist/package/node/components/StatusBar/footer/EventsDrawer.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useGatewayRuns } from '../../../lib/editor-facts-bus.js';
+
+/** epoch ms → "HH:MM:SS"; empty ts renders as a dash. */
+function fmtTime(ms) {
+    if (!ms)
+        return '—';
+    const d = new Date(ms);
+    return d.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: false });
+}
+export function EventsDrawer() {
+    const runs = useGatewayRuns();
+    if (runs.length === 0) {
+        return (_jsx("div", { className: "fx-drawer-content", children: _jsx("div", { className: "fx-empty", children: "\u6682\u65E0\u4E8B\u4EF6 \u00B7 \u5F15\u64CE\u672A\u8FD0\u884C\u6216\u65E0 gateway \u8C03\u7528" }) }));
+    }
+    return (_jsx("div", { className: "fx-drawer-content", children: runs.map((r) => (_jsxs("div", { className: "fx-ev", children: [_jsx("span", { className: "t", children: fmtTime(r.ts) }), _jsx("span", { className: "ev", children: r.operationId }), _jsx("span", { className: "msg", children: r.error ? `${r.status} · ${r.error}` : r.status })] }, r.runId))) }));
+}
+export const eventsDrawerPanel = {
+    id: 'events',
+    title: 'Events',
+    titleKey: 'footerPanel.events',
+    icon: 'Activity',
+    order: 2,
+    render: () => _jsx(EventsDrawer, {}),
+};

package/dist/package/node/components/StatusBar/footer/ForgeaxBuildPopover.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * ForgeaX build projection for the footer.
+ *
+ * This is application build metadata from `/api/version`, not the current
+ * game's Git version. Game version control is contributed by edit-runtime.
+ */
+import { useEffect, useState } from 'react';
+import { createIntervalTaskLifecycle } from '@forgeax/app-shell/react';
+import { Layers } from 'lucide-react';
+import { StripPopover } from '../StripPopover.js';
+
+const FALLBACK = { version: 'v0.?.?.?', sha: '?', date: '?', totalCommits: 0, branch: '?' };
+export function ForgeaxBuildChip() {
+    const [info, setInfo] = useState(FALLBACK);
+    const [tags, setTags] = useState([]);
+    useEffect(() => {
+        let cancelled = false;
+        const refresh = () => {
+            fetch('/api/version')
+                .then((response) => (response.ok ? response.json() : null))
+                .then((data) => {
+                if (!cancelled && data)
+                    setInfo(data);
+            })
+                .catch(() => { });
+            fetch('/api/version/tags')
+                .then((response) => (response.ok ? response.json() : null))
+                .then((data) => {
+                if (!cancelled && data)
+                    setTags(data.tags ?? []);
+            })
+                .catch(() => { });
+        };
+        refresh();
+        const onVisibility = () => {
+            if (document.visibilityState === 'visible')
+                refresh();
+        };
+        document.addEventListener('visibilitychange', onVisibility);
+        window.addEventListener('focus', refresh);
+        const poll = createIntervalTaskLifecycle({
+            task: refresh,
+            intervalMs: 60_000,
+        });
+        poll.start();
+        return () => {
+            cancelled = true;
+            document.removeEventListener('visibilitychange', onVisibility);
+            window.removeEventListener('focus', refresh);
+            poll.dispose();
+        };
+    }, []);
+    return (_jsxs(StripPopover, { icon: "Layers", label: info.version, tooltip: "ForgeaX build version", title: _jsxs(_Fragment, { children: [_jsx(Layers, { size: 13 }), "ForgeaX build"] }), children: [_jsxs("div", { className: "fx-pop-sec", children: [_jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: "Build version" }), _jsx("b", { children: info.version })] }), _jsxs("div", { className: "fx-kv", children: [_jsx("span", { children: "Build identity" }), _jsxs("b", { children: [info.branch, " \u00B7 ", info.sha] })] })] }), _jsx("div", { className: "fx-pop-div" }), tags.length === 0 ? (_jsx("div", { className: "fx-empty", children: "No build tags" })) : (tags.map((tag) => (_jsxs("div", { className: "fx-ver", children: [_jsx("span", { className: "ver", children: tag.tag }), _jsx("span", { className: "lbl", children: tag.message }), _jsx("span", { className: "t", children: tag.date })] }, tag.tag))))] }));
+}
+export const forgeaxBuildVersionStatusItem = {
+    kind: 'status-item',
+    id: 'forgeax-build-version',
+    location: 'statusbar.right',
+    priority: 1000,
+    item: { type: 'custom', render: () => _jsx(ForgeaxBuildChip, {}) },
+};