github-mirrors/nanoclaw-dashboard
1
0
Fork 0
mirror of https://github.com/niels-emmer/nanoclaw-dashboard.git synced 2026-09-13 23:53:29 +02:00
Code Issues 5 Projects Releases 6 Packages Wiki Activity
6 releases 6 tags
  • v1.3.0 59d7f66104

    v1.3.0 — Nanoclaw Instance details screen Stable

    zaph0d released this 2026-09-05 18:29:50 +02:00 | 12 commits to main since this release

    📅 Originally published on GitHub: Sat, 05 Sep 2026 16:31:06 GMT
    🏷️ Git tag created: Sat, 05 Sep 2026 16:29:50 GMT

    The headline of this release is a brand-new full-screen instance deep-dive: click the liveness indicator in the top-right of the status bar to inspect the running nanoclaw instance — its version, resources, configuration files, and live metrics — all updating in real time over the existing WebSocket stream.

    ✨ Features

    Nanoclaw Instance details screen (new)

    Click the liveness indicator (top-right of the status bar) to open a full-screen overlay with three zones:

    • Instance details row — a single line with version, live-ticking uptime, CPU, and memory/disk usage bars.
    • Browse configuration — a collapsible folder tree over the user/group configuration markdown files (agent → projects/sub-divisions). Folders start collapsed and expand on click. In real mode it reads the nanoclaw install root (groups/<folder>/instructions.prepend.md, memory/, projects/, container/CLAUDE.md, container/skills/) via the existing read-only bind mount — no new mount required. Conversation logs are excluded.
    • Metrics bar — messages/errors totals, token buffer (used/limit with progress bar), live time-to-reset countdown, and host details (hostname, platform, Python version, container).
    • "✕ Back to dashboard" closes the screen; uptime and time-to-reset tick locally every second.

    Telemetry schema 0.3.0

    Two new periodic snapshot event types (JSON-encoded in payload.meta, following the topology_snapshot convention):

    • instance_info — instance details + metrics (meta.instance): version, uptime, host, resources, skills, models, agents, tools, and metrics (messages/errors, token buffer, time-to-reset, active agents).
    • config_snapshot — the config folder tree with file metadata only (meta.groups): id, path, name per file. No content — file contents are fetched on demand (see below).

    Emitted by both the mock source (~10/40 ticks) and the real nanoclaw source (~15/60 ticks, plus once on connect).

    GET /api/config/file endpoint (new)

    Serves individual config file contents on demand for the config browser. Origin-validated (403 on disallowed origin), path-traversal-safe, .md-only, 20 KB content cap, proxied through nginx. In mock mode it serves the generated mock config files.

    Live dashboard enhancements

    • Tool icons in the agent roster strip — each roster chip now shows the active tool's category icon.
    • Expandable live activity cards — click a feed card to open the full message + metadata slide-out.
    • Enriched status strip — fleet (active/total), last-activity, msg/min, and a live clock alongside the existing error/stuck/pending alerts.
    • Human node fade — the Human node now fades out during inactivity like other agents.

    🐛 Bug fixes

    • Live activity feed ordering + timezone normalization (#57) — the feed is now consistently newest-on-top and scrolls down as new messages arrive; naive local timestamps from nanoclaw are normalized to UTC so future timestamps no longer appear.
    • Status strip title — made static ("NanoClaw Live Dashboard") instead of reflecting a possibly-changing orchestrator label.
    • config_snapshot glob restriction — found during live testing: the 40-file cap was consumed by the product's own src//docs/ markdown before reaching the agent configs. The glob now collects config-relevant paths only (groups/, container/ minus agent-runner, root *.md), so all agent folders are visible.

    🔧 Dependencies

    • Frontend: @types/react-dom 19.2.5, @types/node 26.4.0, lucide-react 1.35.0, oxlint 1.80.0, @vitejs/plugin-react 6.1.1, @testing-library/react 16.3.3, @testing-library/jest-dom 7.0.1.
    • Backend: uvicorn 0.52.4, python-dotenv 1.2.3.
    • Removed the obsolete version attribute from the compose file.

    📚 Documentation

    • API.md — schema 0.3.0, both new event types, and the GET /api/config/file endpoint documented.
    • ADR 0021 (docs/decision-log.md) — the instance-details design decision, including the metadata-only + on-demand architecture and the marvin = dm-with-niels finding.
    • Threat model — updated for the new disclosure surface: config_snapshot is metadata-only, and /api/config/file is listed as an entry point with its mitigations.
    • README / ARCHITECTURE / CHANGELOG — aligned with the final design.

    ✅ Verification

    • Backend: 24 tests (incl. new endpoint + path-traversal-safety tests).
    • Frontend: 64 tests, lint clean, build clean.
    • Verified live on the nanoclaw host: all 17 agent folders visible in the config tree (marvin = dm-with-niels), on-demand content loading confirmed, backend healthy.
    Downloads