@chenbihao/pomasa-dashboard 1.0.0 → 1.0.2

package/README.md

@@ -1,73 +1,57 @@
-# React + TypeScript + Vite
+# POMASA Dashboard
 
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+A web-based control panel for visualizing and monitoring POMASA multi-agent system (MAS) execution.
 
-Currently, two official plugins are available:
+## Quick Start
 
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+```bash
+npx @chenbihao/pomasa-dashboard
+```
 
-## React Compiler
+The dashboard will start at `http://localhost:3001` and open in your browser automatically.
 
-The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+### Options
 
-## Expanding the ESLint configuration
+```bash
+# Custom port
+npx @chenbihao/pomasa-dashboard --port 8080
 
-If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+# Or via environment variable
+PORT=8080 npx @chenbihao/pomasa-dashboard
+```
 
-```js
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
+## Features
 
-      // Remove tseslint.configs.recommended and replace with this
-      tseslint.configs.recommendedTypeChecked,
-      // Alternatively, use this for stricter rules
-      tseslint.configs.strictTypeChecked,
-      // Optionally, add this for stylistic rules
-      tseslint.configs.stylisticTypeChecked,
+- **Project Overview** — card grid with stats (total, running, completed, alerts), progress bars, and status badges
+- **Pipeline Visualization** — interactive DAG view of agent execution pipelines
+- **Event Timeline** — real-time event and log monitoring
+- **File Viewer** — browse and view project files with syntax highlighting
+- **Embedded Terminal** — built-in web terminal for interacting with projects
+- **Project Creation** — create new MAS projects from templates
+- **i18n** — English and Chinese interface
 
-      // Other configs...
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
-```
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start dev server (frontend + backend with hot reload)
+npm run dev
 
-You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
-
-```js
-// eslint.config.js
-import reactX from 'eslint-plugin-react-x'
-import reactDom from 'eslint-plugin-react-dom'
-
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
-      // Enable lint rules for React
-      reactX.configs['recommended-typescript'],
-      // Enable lint rules for React DOM
-      reactDom.configs.recommended,
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
+# Build for production
+npm run build
+
+# Lint
+npm run lint
 ```
+
+## Tech Stack
+
+- **Frontend**: React 19, TypeScript, Vite, Tailwind CSS, ReactFlow
+- **Backend**: Express 5, WebSocket, node-pty
+- **Terminal**: xterm.js with WebGL renderer
+
+## License
+
+MIT

package/dist/cli.js

@@ -995,19 +995,19 @@ function createApp() {
   });
   return { app, server };
 }
-function startServer(port2, maxRetries = 10) {
+function startServer(port2, host2 = "127.0.0.1", maxRetries = 10) {
   const { server } = createApp();
   return new Promise((resolve, reject) => {
     server.on("error", (err) => {
       if (err.code === "EADDRINUSE" && maxRetries > 0) {
         console.log(`Port ${port2} in use, trying ${port2 + 1}...`);
         server.removeAllListeners("error");
-        startServer(port2 + 1, maxRetries - 1).then(resolve).catch(reject);
+        startServer(port2 + 1, host2, maxRetries - 1).then(resolve).catch(reject);
       } else {
         reject(err);
       }
     });
-    server.listen(port2, () => {
+    server.listen(port2, host2, () => {
       console.log(`POMASA Dashboard running at http://localhost:${port2}`);
       console.log(`API at http://localhost:${port2}/api`);
       console.log(`WebSocket terminal at ws://localhost:${port2}/api/terminal`);
@@ -1030,8 +1030,16 @@ if (portArg !== -1 && process.argv[portArg + 1]) {
 } else if (process.env.PORT) {
   port = parseInt(process.env.PORT, 10);
 }
-startServer(port).then(async () => {
-  const url = `http://localhost:${port}`;
+var host = "127.0.0.1";
+var hostArg = process.argv.indexOf("--host");
+if (hostArg !== -1 && process.argv[hostArg + 1]) {
+  host = process.argv[hostArg + 1];
+} else if (process.env.HOST) {
+  host = process.env.HOST;
+}
+startServer(port, host).then(async () => {
+  const displayHost = host === "0.0.0.0" ? "localhost" : host;
+  const url = `http://${displayHost}:${port}`;
   try {
     const open = (await import("open")).default;
     await open(url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenbihao/pomasa-dashboard",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "POMASA Multi-Agent System Dashboard",
   "repository": {
     "type": "git",