mirror of
https://github.com/zvx-echo6/meshai.git
synced 2026-06-11 01:14:45 +02:00
Closes the audit-doc Section A keystone (the GUI editor). Together with
v0.6-3a foundation, v0.6-3a.1 trim, and v0.6-3b handler wiring, every
Rule-17 CONFIG knob from the audit is now editable in the dashboard
without a container restart.
API (meshai/dashboard/api/adapter_config_routes.py):
GET /api/adapter-config -- {adapter: [{key, value, default,
type, description}]}
GET /api/adapter-config/<adapter> -- one adapter list
GET /api/adapter-config/<adapter>/<key> -- single row
PUT /api/adapter-config/<adapter>/<key> body {value} -- typed validation
int: int or whole-number float; rejects bool, fractional float, str
float: int or float; rejects bool
str: str only
bool: bool only
json: any JSON-serializable value
Every PUT calls invalidate_cache() so the next handler accessor
read sees the new value -- no container restart needed.
POST /api/adapter-config/<adapter>/<key>/reset -- value_json = default_json,
cache invalidated
GET /api/adapter-meta -- {adapter: {display_name,
include_in_llm_context, description}}
PUT /api/adapter-meta/<adapter> partial-update body, fields:
include_in_llm_context: bool, display_name: non-empty str
Dashboard (dashboard-frontend/src/pages/AdapterConfig.tsx):
- Per-adapter cards. Header row shows display_name, the include_in_llm_context
toggle, and an expand chevron. Adapters with zero config keys (e.g. itd_511)
still render so users can toggle their LLM-context inclusion.
- Expanded body lists each key with a type-aware widget:
bool -> checkbox, commit-on-change
int/float -> number input, commit-on-blur (or Enter)
str -> text input, commit-on-blur
json -> textarea, commit-on-blur (JSON.parse with inline error)
Each row shows the key name, type tag, description, "edited" badge when
value != default, a per-key Reset button, and a save badge (spinner,
check, error tooltip, or a small amber dot for unsaved local changes).
- Auto-save semantics: every blur/change/reset triggers PUT immediately;
no explicit Save button needed. Reset is one-click per key.
Wiring:
- meshai/dashboard/server.py registers the new router with prefix /api.
- dashboard-frontend/src/App.tsx adds the /adapter-config route.
- dashboard-frontend/src/components/Layout.tsx adds the left-nav entry
(Sliders icon, label "Adapter Config", after Reference).
- Vite build produces a fresh meshai/dashboard/static bundle. The
Dockerfile copies meshai/ so the new bundle ships with the container
image at next rebuild.
Tests (tests/test_adapter_config_api.py, 30 cases):
- GET grouped, per-adapter, single key
- GET per-adapter returns [] for adapters with zero keys (itd_511)
- PUT updates value, GET shows new value, accessor returns new value
(proves cache invalidation propagates to the in-process accessor)
- PUT type validation per (int, float, str, bool, json) incl. edge cases:
int rejects str + fractional float + bool but accepts whole-number float;
float accepts int + float, rejects bool; bool rejects int; str rejects
other types; json accepts list / dict / None
- PUT 404 on unknown key, 400 on missing value field
- POST reset restores default + invalidates cache
- GET /api/adapter-meta: include_in_llm_context defaults match registry
(central / geocoder false, rest true)
- PUT meta partial update: only provided fields change
- PUT meta rejects non-bool include_in_llm_context, empty display_name,
unknown adapter
Test count: 731 -> 761 (+30 API cases, 0 regressions).
Refs audit doc v0.6-phase1-audit.md Section A keystone + finding #4.
182 lines
6.1 KiB
TypeScript
182 lines
6.1 KiB
TypeScript
import { ReactNode, useEffect, useState } from 'react'
|
|
import { Link, useLocation } from 'react-router-dom'
|
|
import {
|
|
LayoutDashboard,
|
|
Radio,
|
|
Cloud,
|
|
Settings,
|
|
Bell,
|
|
BellRing,
|
|
BookOpen,
|
|
Sliders,
|
|
} from 'lucide-react'
|
|
import { fetchStatus, type SystemStatus } from '@/lib/api'
|
|
import { useWebSocket } from '@/hooks/useWebSocket'
|
|
import { useToast } from './ToastProvider'
|
|
|
|
interface LayoutProps {
|
|
children: ReactNode
|
|
}
|
|
|
|
const navItems = [
|
|
{ path: '/', label: 'Dashboard', icon: LayoutDashboard },
|
|
{ path: '/mesh', label: 'Mesh', icon: Radio },
|
|
{ path: '/environment', label: 'Environment', icon: Cloud },
|
|
{ path: '/config', label: 'Config', icon: Settings },
|
|
{ path: '/alerts', label: 'Alerts', icon: Bell },
|
|
{ path: '/notifications', label: 'Notifications', icon: BellRing },
|
|
{ path: '/reference', label: 'Reference', icon: BookOpen },
|
|
{ path: '/adapter-config', label: 'Adapter Config', icon: Sliders },
|
|
]
|
|
|
|
function formatUptime(seconds: number): string {
|
|
const days = Math.floor(seconds / 86400)
|
|
const hours = Math.floor((seconds % 86400) / 3600)
|
|
const mins = Math.floor((seconds % 3600) / 60)
|
|
|
|
if (days > 0) return `${days}d ${hours}h`
|
|
if (hours > 0) return `${hours}h ${mins}m`
|
|
return `${mins}m`
|
|
}
|
|
|
|
function getPageTitle(pathname: string): string {
|
|
const item = navItems.find((i) => i.path === pathname)
|
|
return item?.label || 'Dashboard'
|
|
}
|
|
|
|
export default function Layout({ children }: LayoutProps) {
|
|
const location = useLocation()
|
|
const { connected, lastAlert } = useWebSocket()
|
|
const { addToast } = useToast()
|
|
const [status, setStatus] = useState<SystemStatus | null>(null)
|
|
const [lastAlertId, setLastAlertId] = useState<string | null>(null)
|
|
|
|
// Trigger toast on new alerts
|
|
useEffect(() => {
|
|
if (lastAlert) {
|
|
const alertId = `${lastAlert.type}-${lastAlert.message}-${lastAlert.timestamp}`
|
|
if (alertId !== lastAlertId) {
|
|
setLastAlertId(alertId)
|
|
addToast(lastAlert)
|
|
}
|
|
}
|
|
}, [lastAlert, lastAlertId, addToast])
|
|
const [currentTime, setCurrentTime] = useState(new Date())
|
|
|
|
useEffect(() => {
|
|
fetchStatus().then(setStatus).catch(console.error)
|
|
const interval = setInterval(() => {
|
|
fetchStatus().then(setStatus).catch(console.error)
|
|
}, 30000)
|
|
return () => clearInterval(interval)
|
|
}, [])
|
|
|
|
useEffect(() => {
|
|
const interval = setInterval(() => setCurrentTime(new Date()), 1000)
|
|
return () => clearInterval(interval)
|
|
}, [])
|
|
|
|
const timeStr = currentTime.toLocaleTimeString('en-US', {
|
|
hour12: false,
|
|
hour: '2-digit',
|
|
minute: '2-digit',
|
|
second: '2-digit',
|
|
})
|
|
|
|
return (
|
|
<div className="flex h-screen overflow-hidden bg-bg text-slate-200">
|
|
{/* Sidebar */}
|
|
<aside className="w-[220px] flex-shrink-0 bg-bg-card border-r border-border flex flex-col overflow-y-auto">
|
|
{/* Logo */}
|
|
<div className="p-5 border-b border-border">
|
|
<div className="flex items-center gap-3">
|
|
<div className="w-10 h-10 rounded-lg bg-gradient-to-br from-blue-500 to-blue-700 flex items-center justify-center text-white font-bold text-xl">
|
|
M
|
|
</div>
|
|
<div>
|
|
<div className="font-semibold text-lg">MeshAI</div>
|
|
<div className="text-xs text-slate-500 font-mono">
|
|
v{status?.version || '...'}
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
{/* Navigation */}
|
|
<nav className="flex-1 py-4">
|
|
{navItems.map((item) => {
|
|
const isActive = location.pathname === item.path
|
|
const Icon = item.icon
|
|
return (
|
|
<Link
|
|
key={item.path}
|
|
to={item.path}
|
|
className={`flex items-center gap-3 px-5 py-3 text-sm transition-colors relative ${
|
|
isActive
|
|
? 'text-blue-400 bg-blue-500/10'
|
|
: 'text-slate-400 hover:text-slate-200 hover:bg-bg-hover'
|
|
}`}
|
|
>
|
|
{isActive && (
|
|
<div className="absolute left-0 top-0 bottom-0 w-0.5 bg-blue-500" />
|
|
)}
|
|
<Icon size={18} />
|
|
{item.label}
|
|
</Link>
|
|
)
|
|
})}
|
|
</nav>
|
|
|
|
{/* Connection status */}
|
|
<div className="p-5 border-t border-border">
|
|
<div className="flex items-center gap-2 mb-2">
|
|
<div
|
|
className={`w-2 h-2 rounded-full ${
|
|
status?.connected ? 'bg-green-500' : 'bg-red-500'
|
|
}`}
|
|
/>
|
|
<span className="text-xs text-slate-400">
|
|
{status?.connected ? 'Connected' : 'Disconnected'}
|
|
</span>
|
|
</div>
|
|
<div className="text-xs text-slate-500 font-mono truncate">
|
|
{status?.connection_type?.toUpperCase()}: {status?.connection_target}
|
|
</div>
|
|
<div className="text-xs text-slate-500 mt-1">
|
|
Uptime: {status ? formatUptime(status.uptime_seconds) : '...'}
|
|
</div>
|
|
</div>
|
|
</aside>
|
|
|
|
{/* Main content */}
|
|
<div className="flex-1 flex flex-col overflow-hidden">
|
|
{/* Header */}
|
|
<header className="h-14 flex-shrink-0 border-b border-border bg-bg-card flex items-center justify-between px-6">
|
|
<h1 className="text-lg font-semibold">
|
|
{getPageTitle(location.pathname)}
|
|
</h1>
|
|
<div className="flex items-center gap-6">
|
|
{/* Live indicator */}
|
|
<div className="flex items-center gap-2">
|
|
<div
|
|
className={`w-2 h-2 rounded-full ${
|
|
connected ? 'bg-green-500 animate-pulse-slow' : 'bg-slate-500'
|
|
}`}
|
|
/>
|
|
<span className="text-xs text-slate-400">
|
|
{connected ? 'Live' : 'Offline'}
|
|
</span>
|
|
</div>
|
|
{/* Clock */}
|
|
<div className="text-sm font-mono text-slate-400">
|
|
{timeStr} MT
|
|
</div>
|
|
</div>
|
|
</header>
|
|
|
|
{/* Page content */}
|
|
<main className="flex-1 overflow-y-auto p-6">{children}</main>
|
|
</div>
|
|
</div>
|
|
)
|
|
}
|