@serkanalgur/opencode-nexus 1.8.0 → 1.8.2

package/README.md

@@ -146,15 +146,36 @@ Failed tasks follow a 4-step escalation chain:
 
 ### Web Dashboard
 
-Real-time monitoring via embedded HTTP + WebSocket server:
+Real-time monitoring via embedded HTTP + WebSocket server on port 4747.
 
+**How to start:**
+
+1. Ask the agent to start the dashboard:
+   ```
+   Use nexus.dashboard.start with port=4747
+   ```
+
+2. Or use the TUI command:
+   ```
+   /nexus web
+   ```
+   This shows instructions and tries to open your browser.
+
+3. Open in browser: `http://localhost:4747`
+
+**What it shows:**
+- Agent grid with role, status, model, and metrics
+- Cost tracker with budget gauge
+- DAG visualization with task dependencies
+- Activity log with all events
+- Config panel (read-only)
+- Auto-refresh every 5 seconds
+
+**Stop the dashboard:**
 ```
-nexus.dashboard.start(port=4747)  # Start server
-# Open http://localhost:4747 in browser
+nexus.dashboard.stop()
 ```
 
-Features: Agent grid, cost tracker, DAG visualization, activity log, config editor, auto-refresh.
-
 ### Team Mode
 
 Create a team of specialist agents working in parallel:

package/dist/index.js

@@ -11536,6 +11536,24 @@ Stop it when done:
 nexus.dashboard.stop()
 \`\`\`
 
+## Git Workflow & Environment Detection
+
+Before starting any work, detect the git environment and follow proper workflow:
+
+### Detection
+- Run \`git status\` to verify it's a git repo
+- Check \`.github/\` or \`.gitlab-ci.yml\` for CI/CD
+- Check \`git remote -v\` for GitHub/GitLab URLs
+
+### Rules
+1. **NEVER push directly to main** — always create a feature branch
+2. **Use conventional commits**: \`feat:\`, \`fix:\`, \`docs:\`, \`chore:\`
+3. **Create PR** for review before merging
+4. **Ask the user** about branching strategy if unclear
+
+### Memory
+Store git workflow preferences in memory for future reference.
+
 ## Quality Gates
 
 ## Phase 2 — Worktrees and snapshots

package/dist/tui.js

@@ -34541,19 +34541,23 @@ var tui_default = define({
                         context.ui.toast.show({
                           title: "⚡ Nexus Web Dashboard",
                           message: [
-                            `Port: ${port}  Host: ${host}`,
+                            `Starting dashboard on port ${port}...`,
                             "",
-                            "To start the dashboard, ask the agent:",
-                            `  nexus.dashboard.start(port=${port}, host="${host}")`,
+                            `Ask the agent to run: nexus.dashboard.start(port=${port})`,
                             "",
-                            `Then open: http://${host}:${port}`,
+                            `Or type: nexus.dashboard.start with port=${port} in your next message`,
                             "",
-                            "Or use /nexus-dashboard for a config summary."
+                            `Then open: http://${host}:${port}`
                           ].join(`
 `),
-                          variant: "info",
-                          duration: 12000
+                          variant: "success",
+                          duration: 8000
                         });
+                        try {
+                          const { exec } = await import("node:child_process");
+                          const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+                          exec(`${cmd} http://${host}:${port}`);
+                        } catch {}
                       }
                       break;
                     case "model":
@@ -34739,27 +34743,33 @@ var tui_default = define({
         budgetRemaining: 10
       }
     });
-    const unsubStorage = context.data.on("model.updated", (event) => {});
+    const unsubSessionSucceeded = context.data.on("session.execution.succeeded", (event) => {
+      const sessionId = event.data.sessionID;
+      setSidebarState((draft) => {
+        const agent = draft.agents.find((a) => a.sessionID === sessionId);
+        if (agent) {
+          agent.status = "completed";
+          agent.tasksCompleted++;
+        }
+      });
+    });
+    const unsubSessionFailed = context.data.on("session.execution.failed", (event) => {
+      const sessionId = event.data.sessionID;
+      setSidebarState((draft) => {
+        const agent = draft.agents.find((a) => a.sessionID === sessionId);
+        if (agent) {
+          agent.status = "failed";
+          agent.tasksFailed++;
+        }
+      });
+    });
     const unsubSidebar = context.ui.slot({
       append: "sidebar.content",
       render: (props) => {
-        const family = context.data.session.family(props.sessionID);
-        const sessions = context.data.session.list();
-        const childSessions = family.filter((id) => id !== props.sessionID).map((id) => context.data.session.get(id)).filter(Boolean);
-        if (childSessions.length === 0 && sidebarState.agents.length === 0) {
+        const agents = sidebarState.agents;
+        if (!agents || agents.length === 0) {
           return null;
         }
-        const agents = sidebarState.agents.length > 0 ? sidebarState.agents : childSessions.map((s) => ({
-          id: s.id,
-          name: s.title || s.id.slice(0, 12),
-          role: "agent",
-          status: "idle",
-          model: "",
-          sessionID: s.id,
-          spawnedAt: new Date().toISOString(),
-          tasksCompleted: 0,
-          tasksFailed: 0
-        }));
         const activeAgents = agents.filter((a) => a.status === "working" || a.status === "idle");
         const completedAgents = agents.filter((a) => a.status === "completed");
         const failedAgents = agents.filter((a) => a.status === "failed");
@@ -34858,7 +34868,8 @@ var tui_default = define({
       }
     });
     return () => {
-      unsubStorage();
+      unsubSessionSucceeded();
+      unsubSessionFailed();
       unsubSidebar();
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serkanalgur/opencode-nexus",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "Adaptive Multi-Agent Orchestration with Cost Intelligence for OpenCode V2",
   "keywords": [
     "opencode",