@serkanalgur/opencode-nexus 2.1.0 → 2.3.0

package/dist/index.js

@@ -11538,10 +11538,60 @@ nexus.spawn(role="coder", task="Implement refresh tokens", wait=false)
 - **architect** — Design system architecture (read-only)
 
 ## Cost & Config
-- Models are configured in nexus.jsonc (project) or ~/.config/opencode/nexus.jsonc (global)
+- Models configured in nexus.jsonc or ~/.config/opencode/nexus.jsonc
 - Use nexus.forecast() to estimate costs before spawning
 - Use nexus.costs() to check budget
-- Use nexus.performance.best(role) to pick the best model for a role
+- Use nexus.performance.best(role) to pick best model for a role
+
+## Git Workflow
+
+When code changes are needed, follow this workflow:
+
+### 1. Pre-Flight
+- Detect git status (clean? on which branch?)
+- Check for CI/CD config (.github/, .gitlab-ci.yml)
+- Verify git identity is set (user.name, user.email)
+
+### 2. Branching
+- NEVER commit directly to main
+- Create feature branch: feat/description, fix/description, chore/description
+- Use conventional branch naming
+
+### 3. Commits
+- Use conventional commits: feat:, fix:, docs:, chore:, refactor:, test:
+- One logical change per commit
+- Imperative mood in commit message
+- Reference issues if applicable
+
+### 4. Pull Request
+- Create PR with descriptive title and body
+- Include: what changed, why, how to test
+- Link related issues
+- Request review
+
+### 5. Merge
+- Squash merge for clean history
+- Delete feature branch after merge
+- Never force push to shared branches
+
+## Delegation Standard
+
+When spawning a sub-agent, provide:
+1. TASK — Atomic, specific goal
+2. EXPECTED OUTCOME — Concrete success criteria
+3. MUST DO — Exhaustive requirements
+4. MUST NOT DO — Forbidden actions
+5. REQUIRED TOOLS — What tools to use
+6. CONTEXT — File paths, patterns, constraints
+
+## Quality Gates
+
+Before marking a task complete:
+1. Code compiles/builds without errors
+2. Tests pass
+3. No security vulnerabilities (use nexus.security.scan)
+4. Follows project conventions
+5. Has appropriate test coverage
 `;
 var src_default = define({
   id: "nexus",
@@ -11880,6 +11930,7 @@ You are a technical writer who creates documentation that developers actually wa
           },
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { detailed } = input;
           const status = orchestrator.getStatus(detailed);
@@ -11897,6 +11948,7 @@ You are a technical writer who creates documentation that developers actually wa
           },
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { filter } = input;
           return { content: orchestrator.listAgents(filter) };
@@ -11910,6 +11962,7 @@ You are a technical writer who creates documentation that developers actually wa
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           return { content: orchestrator.getCostReport() };
         }
@@ -11922,6 +11975,7 @@ You are a technical writer who creates documentation that developers actually wa
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           const state = orchestrator.getState();
           await ctx.storage.set("orchestrator-state", JSON.parse(JSON.stringify(state)));
@@ -11936,6 +11990,7 @@ You are a technical writer who creates documentation that developers actually wa
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           const state = orchestrator.getState();
           const tasks = state.tasks || [];
@@ -11954,6 +12009,7 @@ You are a technical writer who creates documentation that developers actually wa
           required: ["level"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { level, basePath } = input;
           orchestrator.configManager.saveConfig(level, basePath || process.cwd());
@@ -11973,6 +12029,7 @@ You are a technical writer who creates documentation that developers actually wa
           required: ["level"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { level, basePath } = input;
           const path = basePath || process.cwd();
@@ -11999,6 +12056,7 @@ You are a technical writer who creates documentation that developers actually wa
           required: ["name"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { name } = input;
           try {
@@ -12020,6 +12078,7 @@ You are a technical writer who creates documentation that developers actually wa
           },
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { port, host } = input;
           orchestrator.startDashboard(port, host);
@@ -12034,6 +12093,7 @@ You are a technical writer who creates documentation that developers actually wa
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           orchestrator.stopDashboard();
           return { content: "Dashboard stopped" };
@@ -12051,6 +12111,7 @@ You are a technical writer who creates documentation that developers actually wa
           },
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { model, setInput, setOutput } = input;
           if (model && setInput !== undefined && setOutput !== undefined) {
@@ -12091,6 +12152,7 @@ You are a technical writer who creates documentation that developers actually wa
           required: ["role", "task"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { role, task, model, wait, timeout } = input;
           try {
@@ -12227,6 +12289,7 @@ You are a technical writer who creates documentation that developers actually wa
           required: ["role", "task"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { role, task, model, timeout } = input;
           try {
@@ -12290,6 +12353,7 @@ You are a technical writer who creates documentation that developers actually wa
           },
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { name, baseDir } = input;
           if (!name || name === "list") {
@@ -12313,6 +12377,7 @@ You are a technical writer who creates documentation that developers actually wa
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           const scores = orchestrator.performanceTracker.getScores();
           if (scores.length === 0)
@@ -12333,6 +12398,7 @@ You are a technical writer who creates documentation that developers actually wa
           required: ["role"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { role } = input;
           const best = orchestrator.performanceTracker.getBestModel(role);
@@ -12353,6 +12419,7 @@ You are a technical writer who creates documentation that developers actually wa
           required: ["content"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { content, filename } = input;
           const issues = orchestrator.securityScanner.scanContent(content, filename || "unknown");
@@ -12370,6 +12437,7 @@ You are a technical writer who creates documentation that developers actually wa
           },
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { count } = input;
           const records = count ? orchestrator.executionHistory.getRecent(count) : orchestrator.executionHistory.getAll();
@@ -12388,6 +12456,7 @@ You are a technical writer who creates documentation that developers actually wa
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           const stats = orchestrator.executionHistory.getStats();
           return { content: `Total: ${stats.total} | Success: ${(stats.successRate * 100).toFixed(1)}% | Cost: $${stats.totalCost.toFixed(4)} | Avg: ${stats.avgDuration.toFixed(0)}ms
@@ -12402,6 +12471,7 @@ By role: ${JSON.stringify(stats.byRole)}` };
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           const roles = orchestrator.customRoles.list();
           if (roles.length === 0)
@@ -12425,6 +12495,7 @@ By role: ${JSON.stringify(stats.byRole)}` };
           },
           required: ["name", "displayName", "prompt"]
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { name, displayName, emoji, prompt, model } = input;
           orchestrator.customRoles.register({ name, displayName, emoji: emoji || "\uD83E\uDD16", prompt, model });
@@ -12441,6 +12512,7 @@ By role: ${JSON.stringify(stats.byRole)}` };
           },
           required: ["tasks"]
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { tasks } = input;
           const taskList = JSON.parse(tasks);
@@ -12475,6 +12547,7 @@ Total: ~$${result.totalEstimatedCost.toFixed(4)}`);
         name: "worktree.enable",
         description: "Enable git worktree isolation for agents",
         input: { type: "object", properties: { repoRoot: { type: "string", description: "Repository root (defaults to cwd)" } } },
+        options: { codemode: true },
         execute: async (input) => {
           const { repoRoot } = input;
           orchestrator.enableWorktrees(repoRoot || process.cwd());
@@ -12485,6 +12558,7 @@ Total: ~$${result.totalEstimatedCost.toFixed(4)}`);
         name: "worktree.list",
         description: "List active agent worktrees",
         input: { type: "object", properties: {}, additionalProperties: false },
+        options: { codemode: true },
         execute: async () => {
           if (!orchestrator.worktreeManager)
             return { content: "Worktree isolation not enabled." };
@@ -12499,6 +12573,7 @@ Total: ~$${result.totalEstimatedCost.toFixed(4)}`);
         name: "worktree.disable",
         description: "Disable worktree isolation and clean up",
         input: { type: "object", properties: {}, additionalProperties: false },
+        options: { codemode: true },
         execute: async () => {
           if (orchestrator.worktreeManager) {
             orchestrator.worktreeManager.cleanupAll();
@@ -12511,6 +12586,7 @@ Total: ~$${result.totalEstimatedCost.toFixed(4)}`);
         name: "sessions",
         description: "List all active Nexus agent sessions",
         input: { type: "object", properties: {}, additionalProperties: false },
+        options: { codemode: true },
         execute: async () => {
           const agents = orchestrator.getState().agents;
           if (agents.length === 0)
@@ -12528,6 +12604,7 @@ ${lines.join(`
         name: "background",
         description: "Move running agents to background (detach from current session)",
         input: { type: "object", properties: {}, additionalProperties: false },
+        options: { codemode: true },
         execute: async () => {
           const agents = orchestrator.getState().agents.filter((a) => a.status === "working" || a.status === "idle");
           if (agents.length === 0)
@@ -12550,6 +12627,7 @@ ${lines.join(`
           },
           required: ["sessionID"]
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { sessionID } = input;
           try {
@@ -12578,6 +12656,7 @@ ${lastMsg.content}` };
           required: ["question"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { question, options, assumption } = input;
           const optionList = options ? options.split(",").map((o) => o.trim()) : [];
@@ -12605,6 +12684,7 @@ Options: ${optionList.map((o, i) => `${i + 1}. ${o}`).join(", ")}`;
           required: ["description"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { description, assignedTo } = input;
           const item = orchestrator.todoEnforcer.add(description, assignedTo);
@@ -12619,6 +12699,7 @@ Options: ${optionList.map((o, i) => `${i + 1}. ${o}`).join(", ")}`;
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           return { content: orchestrator.todoEnforcer.formatAll() };
         }
@@ -12634,6 +12715,7 @@ Options: ${optionList.map((o, i) => `${i + 1}. ${o}`).join(", ")}`;
           required: ["id"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { id } = input;
           const item = orchestrator.todoEnforcer.get(id);
@@ -12651,6 +12733,7 @@ Options: ${optionList.map((o, i) => `${i + 1}. ${o}`).join(", ")}`;
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           const stats = orchestrator.todoEnforcer.getStats();
           return {
@@ -12675,6 +12758,7 @@ Options: ${optionList.map((o, i) => `${i + 1}. ${o}`).join(", ")}`;
           required: ["description"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { description, autoContinue } = input;
           const goal = goalManager.set(description, autoContinue ?? true);
@@ -12685,6 +12769,7 @@ Options: ${optionList.map((o, i) => `${i + 1}. ${o}`).join(", ")}`;
         name: "goal.status",
         description: "Show current goal status",
         input: { type: "object", properties: {}, additionalProperties: false },
+        options: { codemode: true },
         execute: async () => {
           const goal = goalManager.getActive();
           if (!goal)
@@ -12698,6 +12783,7 @@ Tasks: ${goal.tasks.length}` };
         name: "goal.complete",
         description: "Complete current goal",
         input: { type: "object", properties: {}, additionalProperties: false },
+        options: { codemode: true },
         execute: async () => {
           const goal = goalManager.getActive();
           if (!goal)
@@ -12710,6 +12796,7 @@ Tasks: ${goal.tasks.length}` };
         name: "goal.list",
         description: "List all goals",
         input: { type: "object", properties: {}, additionalProperties: false },
+        options: { codemode: true },
         execute: async () => {
           const goals = goalManager.getAll();
           if (goals.length === 0)
@@ -12727,6 +12814,7 @@ Tasks: ${goal.tasks.length}` };
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           const active = goalManager.getActive();
           if (!active)
@@ -12753,6 +12841,7 @@ Tasks: ${goal.tasks.length}` };
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           const active = goalManager.getActive();
           if (!active)
@@ -12777,6 +12866,7 @@ Tasks: ${goal.tasks.length}` };
           properties: {},
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async () => {
           const goals = goalManager.getAll();
           if (goals.length === 0)
@@ -12804,6 +12894,7 @@ ${lines.join(`
           required: ["name", "leadRole"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { name, leadRole } = input;
           const team = teamManager.create(name, leadRole);
@@ -12827,6 +12918,7 @@ Add members with nexus.team.addMember(teamId="${team.id}", role="...", model="..
           required: ["teamId", "role", "model"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { teamId, role, model } = input;
           const member = teamManager.addMember(teamId, role, model);
@@ -12853,6 +12945,7 @@ Total members: ${team?.members.length || 0}` };
           },
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { teamId } = input;
           if (teamId) {
@@ -12890,6 +12983,7 @@ ${lines.join(`
           required: ["teamId"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { teamId } = input;
           const team = teamManager.get(teamId);
@@ -12920,6 +13014,7 @@ ${team.members.map((m) => `  - ${m.role}: ${m.model}`).join(`
           required: ["pattern", "language", "directory"],
           additionalProperties: false
         },
+        options: { codemode: true },
         execute: async (input) => {
           const { pattern, language, directory } = input;
           const results = astGrep.search(pattern, language, directory);
@@ -12935,6 +13030,7 @@ ${lines.join(`
         name: "astgrep.status",
         description: "Check if ast-grep is installed",
         input: { type: "object", properties: {}, additionalProperties: false },
+        options: { codemode: true },
         execute: async () => {
           const available = astGrep.isAvailable();
           return { content: available ? "✅ ast-grep is installed" : "❌ ast-grep is not installed. Install with: cargo install ast-grep" };

package/dist/tui.js

@@ -34857,104 +34857,117 @@ var tui_default = define({
           pollChildSessions();
         } catch {}
         const agents = sidebarState.agents;
-        if (!agents || agents.length === 0) {
+        if (!agents || agents.length === 0)
           return null;
-        }
-        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");
-        return /* @__PURE__ */ jsxDEV("div", {
-          style: {
-            padding: "8px",
-            borderTop: "1px solid #333",
-            marginTop: "8px"
-          },
-          children: [
-            /* @__PURE__ */ jsxDEV("div", {
-              style: {
-                fontSize: "11px",
-                color: "#888",
-                marginBottom: "4px",
-                display: "flex",
-                justifyContent: "space-between",
-                alignItems: "center"
-              },
-              children: [
-                /* @__PURE__ */ jsxDEV("span", {
-                  children: "\uD83E\uDD16 Nexus Agents"
-                }, undefined, false, undefined, this),
-                /* @__PURE__ */ jsxDEV("span", {
-                  style: { color: "#666" },
+        try {
+          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");
+          return /* @__PURE__ */ jsxDEV("div", {
+            style: {
+              padding: "8px",
+              borderTop: "1px solid #333",
+              marginTop: "8px"
+            },
+            children: [
+              /* @__PURE__ */ jsxDEV("div", {
+                style: {
+                  fontSize: "11px",
+                  color: "#888",
+                  marginBottom: "4px",
+                  display: "flex",
+                  justifyContent: "space-between",
+                  alignItems: "center"
+                },
+                children: [
+                  /* @__PURE__ */ jsxDEV("span", {
+                    children: "\uD83E\uDD16 Nexus Agents"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("span", {
+                    style: { color: "#666" },
+                    children: [
+                      activeAgents.length,
+                      " active"
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              activeAgents.map((agent) => /* @__PURE__ */ jsxDEV("div", {
+                style: {
+                  fontSize: "10px",
+                  padding: "2px 0",
+                  color: agent.status === "working" ? "#4ade80" : "#94a3b8"
+                },
+                children: [
+                  /* @__PURE__ */ jsxDEV("span", {
+                    children: agent.status === "working" ? "\uD83D\uDD04" : "⏸️"
+                  }, undefined, false, undefined, this),
+                  " ",
+                  agent.name,
+                  agent.model && /* @__PURE__ */ jsxDEV("span", {
+                    style: { color: "#64748b" },
+                    children: [
+                      " — ",
+                      agent.model.split("/").pop()
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, agent.id, true, undefined, this)),
+              completedAgents.length > 0 && /* @__PURE__ */ jsxDEV("div", {
+                style: {
+                  marginTop: "4px",
+                  paddingTop: "4px",
+                  borderTop: "1px solid #222"
+                },
+                children: /* @__PURE__ */ jsxDEV("div", {
+                  style: { fontSize: "10px", color: "#666", marginBottom: "2px" },
                   children: [
-                    activeAgents.length,
-                    " active"
+                    "✅ ",
+                    completedAgents.length,
+                    " completed"
                   ]
                 }, undefined, true, undefined, this)
-              ]
-            }, undefined, true, undefined, this),
-            activeAgents.map((agent) => /* @__PURE__ */ jsxDEV("div", {
-              style: {
-                fontSize: "10px",
-                padding: "2px 0",
-                color: agent.status === "working" ? "#4ade80" : "#94a3b8"
-              },
-              children: [
-                /* @__PURE__ */ jsxDEV("span", {
-                  children: agent.status === "working" ? "\uD83D\uDD04" : "⏸️"
-                }, undefined, false, undefined, this),
-                " ",
-                agent.name,
-                agent.model && /* @__PURE__ */ jsxDEV("span", {
-                  style: { color: "#64748b" },
+              }, undefined, false, undefined, this),
+              failedAgents.length > 0 && /* @__PURE__ */ jsxDEV("div", {
+                style: { marginTop: "2px" },
+                children: /* @__PURE__ */ jsxDEV("div", {
+                  style: { fontSize: "10px", color: "#ef4444", marginBottom: "2px" },
                   children: [
-                    " — ",
-                    agent.model.split("/").pop()
+                    "❌ ",
+                    failedAgents.length,
+                    " failed"
                   ]
                 }, undefined, true, undefined, this)
-              ]
-            }, agent.id, true, undefined, this)),
-            completedAgents.length > 0 && /* @__PURE__ */ jsxDEV("div", {
-              style: {
-                marginTop: "4px",
-                paddingTop: "4px",
-                borderTop: "1px solid #222"
-              },
-              children: /* @__PURE__ */ jsxDEV("div", {
-                style: { fontSize: "10px", color: "#666", marginBottom: "2px" },
-                children: [
-                  "✅ ",
-                  completedAgents.length,
-                  " completed"
-                ]
-              }, undefined, true, undefined, this)
-            }, undefined, false, undefined, this),
-            failedAgents.length > 0 && /* @__PURE__ */ jsxDEV("div", {
-              style: { marginTop: "2px" },
-              children: /* @__PURE__ */ jsxDEV("div", {
-                style: { fontSize: "10px", color: "#ef4444", marginBottom: "2px" },
+              }, undefined, false, undefined, this),
+              sidebarState.totalCost > 0 && /* @__PURE__ */ jsxDEV("div", {
+                style: {
+                  marginTop: "4px",
+                  fontSize: "10px",
+                  color: "#666"
+                },
                 children: [
-                  "❌ ",
-                  failedAgents.length,
-                  " failed"
+                  "\uD83D\uDCB0 $",
+                  sidebarState.totalCost.toFixed(4),
+                  " / $",
+                  sidebarState.budgetRemaining.toFixed(2),
+                  " remaining"
                 ]
               }, undefined, true, undefined, this)
-            }, undefined, false, undefined, this),
-            sidebarState.totalCost > 0 && /* @__PURE__ */ jsxDEV("div", {
-              style: {
-                marginTop: "4px",
-                fontSize: "10px",
-                color: "#666"
-              },
-              children: [
-                "\uD83D\uDCB0 $",
-                sidebarState.totalCost.toFixed(4),
-                " / $",
-                sidebarState.budgetRemaining.toFixed(2),
-                " remaining"
-              ]
-            }, undefined, true, undefined, this)
-          ]
-        }, undefined, true, undefined, this);
+            ]
+          }, undefined, true, undefined, this);
+        } catch {
+          const active = agents.filter((a) => a.status === "working").length;
+          const failed = agents.filter((a) => a.status === "failed").length;
+          const completed = agents.filter((a) => a.status === "completed").length;
+          const parts = [`${agents.length} agents`];
+          if (active > 0)
+            parts.push(`${active} active`);
+          if (completed > 0)
+            parts.push(`${completed} done`);
+          if (failed > 0)
+            parts.push(`${failed} failed`);
+          return `\uD83E\uDD16 ${parts.join(", ")}`;
+        }
       }
     });
     return () => {

package/package.json

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