Merge pull request #5 from rohas-dev/feat/workbench-ui

Add Rohas Workbench - Next.js Dashboard for Local Development

Author: sophatvathana

.gitignore

@@ -19,3 +19,10 @@ target
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
+
+# Workbench frontend artifacts
+workbench/node_modules
+workbench/.next
+workbench/out
+workbench/.turbo
+workbench/.vercel

examples/hello-world/config/rohas.toml

@@ -11,3 +11,7 @@ enable_cors = true
 [adapter]
 type = "memory"
 buffer_size = 1000
+
+[workbench]
+allowed_origins = []
+api_key = "FRmz/+AjTYCUFlBMio479A=="

examples/hello-world/schema/cron/cron.ro

@@ -1,3 +1,3 @@
-//cron DailyCleanup {
- // schedule: "*/2 * * * * *"
-//}
+cron DailyCleanup {
+ schedule: "*/2 * * * * *"
+}

examples/hello-world/src/generated/state.py

@@ -7,12 +7,80 @@ class TriggeredEvent(BaseModel):
     payload: Dict[str, Any]
 
 
+class Logger:
+    """Logger for handlers to emit structured logs."""
+    
+    def __init__(self, handler_name: str, log_fn: Any):
+        self._handler_name = handler_name
+        self._log_fn = log_fn
+    
+    def info(self, message: str, **kwargs: Any) -> None:
+        """Log an info message.
+        
+        Args:
+            message: Log message
+            **kwargs: Additional fields to include in the log
+        """
+        if self._log_fn:
+            self._log_fn("info", self._handler_name, message, kwargs)
+    
+    def error(self, message: str, **kwargs: Any) -> None:
+        """Log an error message.
+        
+        Args:
+            message: Log message
+            **kwargs: Additional fields to include in the log
+        """
+        if self._log_fn:
+            self._log_fn("error", self._handler_name, message, kwargs)
+    
+    def warning(self, message: str, **kwargs: Any) -> None:
+        """Log a warning message.
+        
+        Args:
+            message: Log message
+            **kwargs: Additional fields to include in the log
+        """
+        if self._log_fn:
+            self._log_fn("warn", self._handler_name, message, kwargs)
+    
+    def warn(self, message: str, **kwargs: Any) -> None:
+        """Log a warning message (alias for warning).
+        
+        Args:
+            message: Log message
+            **kwargs: Additional fields to include in the log
+        """
+        self.warning(message, **kwargs)
+    
+    def debug(self, message: str, **kwargs: Any) -> None:
+        """Log a debug message.
+        
+        Args:
+            message: Log message
+            **kwargs: Additional fields to include in the log
+        """
+        if self._log_fn:
+            self._log_fn("debug", self._handler_name, message, kwargs)
+    
+    def trace(self, message: str, **kwargs: Any) -> None:
+        """Log a trace message.
+        
+        Args:
+            message: Log message
+            **kwargs: Additional fields to include in the log
+        """
+        if self._log_fn:
+            self._log_fn("trace", self._handler_name, message, kwargs)
+
+
 class State:
     """Context object for handlers to trigger events and access runtime state."""
 
-    def __init__(self):
+    def __init__(self, handler_name: Optional[str] = None, log_fn: Optional[Any] = None):
         self._triggers: List[TriggeredEvent] = []
         self._auto_trigger_payloads: Dict[str, Dict[str, Any]] = {}
+        self.logger = Logger(handler_name or "unknown", log_fn)
 
     def trigger_event(self, event_name: str, payload: Dict[str, Any]) -> None:
         """Manually trigger an event with the given payload.

examples/hello-world/src/handlers/api/test.py

@@ -24,5 +24,12 @@ async def handle_test(req: TestRequest, state: State) -> TestResponse:
     state.trigger_event('ManualTrigger', {
         'payload': 'Hello, world!'
     })
-
+    
+    state.logger.info('Hello, world!')
+    state.logger.error('Hello, world!')
+    state.logger.warning('Hello, world!')
+    state.logger.warn('Hello, world!')
+    state.logger.debug('Hello, world!')
+    state.logger.trace('Hello, world!')
+ 
     return TestResponse(data="Hello, world!")

workbench/.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

workbench/README.md

@@ -0,0 +1,50 @@
+# Workbench
+
+Rohas Workbench is a Next.js dashboard that pairs generated Rohas projects with a modern shadcn/ui front-end. It automatically detects the nearest `config/rohas.toml`, parses your local schemas/handlers, and surfaces health signals without needing a backend service.
+
+## Stack
+
+- Next.js 16 / React 19 (App Router)
+- Tailwind CSS 3.4 + shadcn/ui primitives (`src/components/ui/*`)
+- next-themes for dark/light modes
+- `toml` parser to read Cargo metadata straight from disk
+
+## Getting started
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Visit http://localhost:3000 to view the dashboard. Updating schema files under `./schema` or handlers under `./src/handlers` immediately updates the inventory, because Workbench reads directly from disk on every request.
+
+## Scripts
+
+```bash
+pnpm lint       # next lint (core-web-vitals rules)
+pnpm typecheck  # tsc --noEmit
+pnpm format     # prettier on src/**/*.{ts,tsx}
+pnpm build && pnpm start
+```
+
+## Project layout & routes
+
+- `src/app/(workbench)` – Overview, Schemas, Schema Graph, Workflows, Tracing, CLI, Settings routes
+- `src/app/(workbench)/workflows/[slug]` – interactive workflow viewer
+- `src/app/(workbench)/tracing` – schema-derived trace explorer
+- `src/components/ui` – reusable shadcn primitives (button, card, tabs, etc.)
+- `src/components/workbench` – domain widgets (sidebar, header, schema browser, workflow tools)
+- `src/stores/workbench-store.ts` – Zustand store for cross-route search & navigation state
+- `src/lib/project.ts` / `src/lib/workbench-data.ts` – filesystem helpers that discover schema, handler, and workflow assets
+
+Because the UI executes inside the same repo as the generated Rohas project, no network calls are required—Workbench renders everything from local state, which keeps the feedback loop fast even when offline.
+
+## Project root detection
+
+Workbench walks up from the app directory until it finds `config/rohas.toml`, which becomes the project root. Override this detection with:
+
+```bash
+ROHAS_PROJECT_ROOT=/absolute/path/to/project pnpm dev
+```
+
+The override is especially helpful when running the dashboard from a globally installed bundle or when the project structure deviates from the default generator layout.

workbench/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

workbench/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;

workbench/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "rohas-workbench",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint . --ext ts,tsx --max-warnings=0",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  },
+  "dependencies": {
+    "@monaco-editor/react": "^4.7.0",
+    "@radix-ui/react-avatar": "^1.0.4",
+    "@radix-ui/react-dropdown-menu": "^2.0.6",
+    "@radix-ui/react-label": "^2.0.2",
+    "@radix-ui/react-popover": "^1.0.7",
+    "@radix-ui/react-scroll-area": "^1.0.5",
+    "@radix-ui/react-separator": "^1.0.3",
+    "@radix-ui/react-slot": "^1.0.2",
+    "@radix-ui/react-tabs": "^1.0.4",
+    "@radix-ui/react-tooltip": "^1.0.7",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "@xyflow/react": "^12.9.3",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.1",
+    "dagre": "^0.8.5",
+    "lucide-react": "^0.475.0",
+    "next": "16.0.5",
+    "next-themes": "^0.4.4",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "react-resizable-panels": "^3.0.6",
+    "react-syntax-highlighter": "^16.1.0",
+    "tailwind-merge": "^2.5.2",
+    "tailwindcss-animate": "^1.0.7",
+    "toml": "^3.0.0",
+    "zustand": "^4.5.2"
+  },
+  "devDependencies": {
+    "@types/dagre": "^0.7.53",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^9",
+    "eslint-config-next": "16.0.5",
+    "postcss": "^8.4.47",
+    "prettier": "^3.3.3",
+    "tailwindcss": "^3.4.13",
+    "typescript": "^5.6.3"
+  }
+}