@aaronbassett/midnight-local-devnet 0.1.2 → 0.3.0

package/README.md

@@ -13,16 +13,16 @@ A CLI and MCP (Model Context Protocol) server for managing a local Docker-based
 
 ### CLI
 
-Run with no arguments to enter interactive mode:
+Start the network:
 
 ```bash
-npx @aaronbassett/midnight-local-devnet
+npx @aaronbassett/midnight-local-devnet start
 ```
 
-Or start the network directly:
+Open the dashboard in your browser to monitor your devnet:
 
 ```bash
-npx @aaronbassett/midnight-local-devnet start
+npx @aaronbassett/midnight-local-devnet dashboard
 ```
 
 ### MCP Server
@@ -58,9 +58,38 @@ All commands can be run via `npx @aaronbassett/midnight-local-devnet <command>`.
 | `fund <address>` | Fund a Bech32 address with NIGHT tokens | `--amount <n>` Amount in NIGHT (default: 50,000) |
 | `fund-file <path>` | Fund all accounts from an accounts.json file | |
 | `generate-accounts` | Generate random test accounts | `--count <n>`, `--format <mnemonic\|privateKey>`, `--output <path>`, `--fund`, `--register-dust` |
+| `dashboard` | Open browser dashboard | `--port <n>` (default: 31780), `--no-open` Suppress auto-open |
 | `interactive` | Start interactive menu mode | |
 
-Running with no arguments automatically enters interactive mode.
+Running with no arguments displays help.
+
+## Dashboard
+
+The `dashboard` command starts a local server and opens a browser-based dashboard that displays the state of all local devnet services in real time.
+
+```bash
+npx @aaronbassett/midnight-local-devnet dashboard
+```
+
+This starts a server on `http://localhost:31780` and opens your default browser. Press Ctrl+C in the terminal to stop.
+
+Options:
+
+- `--port <n>` -- Use a specific port (default: 31780, auto-increments if in use)
+- `--no-open` -- Start the server without opening the browser
+
+The dashboard shows:
+
+- **Node** -- Block height, average block time, chain, peers, sync status, version
+- **Indexer** -- Ready status, response time
+- **Proof Server** -- Version, proof versions, job processing/pending/capacity gauge
+- **Wallet** -- Master wallet NIGHT (unshielded + shielded) and DUST balances
+- **Response Times** -- SVG sparkline charts of per-service response times
+- **Logs** -- Combined color-coded log stream from all services, filterable by service, level, or text search
+
+The dashboard connects to the server via WebSocket for live updates. If the connection drops, it auto-reconnects. You can start and stop the network directly from the dashboard using the action buttons.
+
+The layout is responsive and adapts to your browser window width.
 
 ## MCP Tool Reference
 

package/dist/cli/commands/dashboard.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+import type { NetworkManager } from '../../core/network-manager.js';
+export declare function registerDashboardCommand(program: Command, manager: NetworkManager): void;

package/dist/cli/commands/dashboard.js

@@ -0,0 +1,59 @@
+import { createServer } from 'node:net';
+async function findOpenPort(start, maxAttempts = 10) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = start + i;
+        const available = await new Promise((resolve) => {
+            const server = createServer();
+            server.once('error', () => resolve(false));
+            server.once('listening', () => {
+                server.close(() => resolve(true));
+            });
+            server.listen(port, '127.0.0.1');
+        });
+        if (available)
+            return port;
+    }
+    throw new Error(`No open port found in range ${start}-${start + maxAttempts - 1}`);
+}
+export function registerDashboardCommand(program, manager) {
+    program
+        .command('dashboard')
+        .description('Open browser dashboard for the local devnet')
+        .option('--port <port>', 'Port to serve dashboard on', '31780')
+        .option('--no-open', 'Do not auto-open the browser')
+        .action(async (opts) => {
+        const { createDashboardApp } = await import('../dashboard/server.js');
+        const { serve } = await import('@hono/node-server');
+        const open = (await import('open')).default;
+        const preferredPort = parseInt(opts.port, 10);
+        const port = await findOpenPort(preferredPort);
+        const { app, setupWebSocket, startPolling, shutdown } = createDashboardApp({
+            config: manager.config,
+            manager,
+            port,
+        });
+        const server = serve({ fetch: app.fetch, port, hostname: '127.0.0.1' }, (info) => {
+            const url = `http://localhost:${info.port}`;
+            console.log(`Dashboard running at ${url}`);
+            console.log('Press Ctrl+C to stop\n');
+            if (opts.open !== false) {
+                open(url).catch(() => {
+                    // Ignore browser open errors
+                });
+            }
+        });
+        const wss = setupWebSocket(server);
+        startPolling();
+        const gracefulShutdown = async () => {
+            console.log('\nShutting down dashboard...');
+            shutdown();
+            wss.close();
+            await new Promise((resolve) => server.close(() => resolve()));
+            await manager.shutdown();
+            process.exit(0);
+        };
+        process.on('SIGINT', gracefulShutdown);
+        process.on('SIGTERM', gracefulShutdown);
+    });
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/cli/commands/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../../src/cli/commands/dashboard.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/interactive.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+import type { NetworkManager } from '../../core/network-manager.js';
+export declare function registerInteractiveCommand(program: Command, manager: NetworkManager): void;

package/dist/cli/commands/interactive.js

@@ -0,0 +1,16 @@
+import { startInteractiveMode } from '../interactive.js';
+export function registerInteractiveCommand(program, manager) {
+    program
+        .command('interactive')
+        .description('Start interactive menu mode')
+        .action(async () => {
+        try {
+            await startInteractiveMode(manager);
+        }
+        catch (error) {
+            console.error('Interactive mode error:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=interactive.js.map

package/dist/cli/commands/interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../../src/cli/commands/interactive.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,UAAU,0BAA0B,CAAC,OAAgB,EAAE,OAAuB;IAClF,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/dashboard/html.d.ts

@@ -0,0 +1,3 @@
+export declare function generateDashboardHtml({ wsUrl }: {
+    wsUrl: string;
+}): string;