neohive 6.0.2 → 6.0.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [6.0.3] - 2026-04-03
+
+### Fixed
+
+- **MCP data directory** — When the MCP process starts with cwd outside the repo (e.g. Cursor home) and no `NEOHIVE_DATA_DIR`, resolve the hive from repo `.cursor/mcp.json` / sibling config (`lib/resolve-server-data-dir.js`); `lib/config.js` uses the same root so agents and dashboard agree.
+- **Dashboard `projects.json`** — Only rewrite the projects file when the canonical list differs from on-disk data (`pack(nonRedundant) !== pack(raw)`), not on every load when duplicates or default-hive rows were only present in the normalized pass-through list.
+
 ## [5.1.0] - 2026-03-19
 
 ### Major — True Autonomy Engine + Team Intelligence + Scale to 100

package/cli.js

@@ -17,9 +17,12 @@ function printUsage() {
     npx neohive init --claude       Configure for Claude Code only
     npx neohive init --gemini       Configure for Gemini CLI only
     npx neohive init --codex        Configure for Codex CLI only
-    npx neohive init --all          Configure for all detected CLIs
+    npx neohive init --cursor       Configure for Cursor IDE only (.cursor/mcp.json)
+    npx neohive init --all          Configure for all supported CLIs
     npx neohive init --ollama       Setup Ollama local LLM bridge
     npx neohive init --template T   Initialize with a team template
+    npx neohive serve               Run MCP server in HTTP mode (port 4321)
+    npx neohive serve --port 8080   Custom port for HTTP server
     npx neohive dashboard           Launch web dashboard (http://localhost:3000)
     npx neohive dashboard --lan     Dashboard accessible on LAN
     npx neohive status              Show active agents and tasks
@@ -55,6 +58,11 @@ function detectCLIs() {
     detected.push('codex');
   }
 
+  // Cursor IDE: ~/.cursor/ (app support) exists
+  if (fs.existsSync(path.join(home, '.cursor'))) {
+    detected.push('cursor');
+  }
+
   return detected;
 }
 
@@ -167,6 +175,41 @@ timeout = 300
   console.log('  [ok] Codex CLI: .codex/config.toml updated');
 }
 
+// Configure for Cursor IDE — absolute NEOHIVE_DATA_DIR so Node never sees unexpanded ${workspaceFolder}.
+// If the IDE omits env on spawn, server startup still resolves the hive via lib/resolve-server-data-dir.js
+// (walks cwd ancestors for the same MCP files).
+function setupCursor(serverPath, cwd) {
+  const cursorDir = path.join(cwd, '.cursor');
+  const mcpConfigPath = path.join(cursorDir, 'mcp.json');
+  const abDataDir = path.join(path.resolve(cwd), '.neohive').replace(/\\/g, '/');
+
+  if (!fs.existsSync(cursorDir)) {
+    fs.mkdirSync(cursorDir, { recursive: true });
+  }
+
+  let mcpConfig = { mcpServers: {} };
+  if (fs.existsSync(mcpConfigPath)) {
+    try {
+      mcpConfig = JSON.parse(fs.readFileSync(mcpConfigPath, 'utf8'));
+      if (!mcpConfig.mcpServers) mcpConfig.mcpServers = {};
+    } catch {
+      const backup = mcpConfigPath + '.backup';
+      fs.copyFileSync(mcpConfigPath, backup);
+      console.log('  [warn] Existing .cursor/mcp.json was invalid — backed up to mcp.json.backup');
+    }
+  }
+
+  mcpConfig.mcpServers['neohive'] = {
+    command: 'node',
+    args: [serverPath],
+    env: { NEOHIVE_DATA_DIR: abDataDir },
+    timeout: 300,
+  };
+
+  fs.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2) + '\n');
+  console.log('  [ok] Cursor IDE: .cursor/mcp.json updated');
+}
+
 // Setup Ollama agent bridge script
 function setupOllama(serverPath, cwd) {
   const dir = dataDir(cwd);
@@ -314,8 +357,10 @@ function init() {
     targets = ['gemini'];
   } else if (flag === '--codex') {
     targets = ['codex'];
+  } else if (flag === '--cursor') {
+    targets = ['cursor'];
   } else if (flag === '--all') {
-    targets = ['claude', 'gemini', 'codex'];
+    targets = ['claude', 'gemini', 'codex', 'cursor'];
   } else if (flag === '--ollama') {
     const ollama = detectOllama();
     if (!ollama.installed) {
@@ -347,11 +392,12 @@ function init() {
       case 'claude': setupClaude(serverPath, cwd); break;
       case 'gemini': setupGemini(serverPath, cwd); break;
       case 'codex':  setupCodex(serverPath, cwd);  break;
+      case 'cursor': setupCursor(serverPath, cwd); break;
     }
   }
 
   // Add .neohive/ and MCP config files to .gitignore
-  const gitignoreEntries = ['.neohive/', '.mcp.json', '.codex/', '.gemini/'];
+  const gitignoreEntries = ['.neohive/', '.mcp.json', '.cursor/mcp.json', '.codex/', '.gemini/'];
   if (fs.existsSync(gitignorePath)) {
     let content = fs.readFileSync(gitignorePath, 'utf8');
     const missing = gitignoreEntries.filter(e => !content.includes(e));
@@ -367,8 +413,13 @@ function init() {
     console.log('  [ok] .gitignore created');
   }
 
+  const configuredCursor = targets.includes('cursor');
   console.log('');
-  console.log('  Neohive is ready! Restart your CLI to pick up the MCP tools.');
+  console.log(
+    configuredCursor
+      ? '  Neohive is ready! Restart Cursor (or reload MCP tools) and restart any terminal CLIs you use.'
+      : '  Neohive is ready! Restart your CLI to pick up the MCP tools.'
+  );
   console.log('');
 
   // Show template if --template was provided
@@ -383,7 +434,11 @@ function init() {
   if (templateFlag) {
     showTemplate(templateFlag);
   } else {
-    console.log('  Open two terminals and start a conversation between agents.');
+    if (configuredCursor) {
+      console.log('  Cursor: use register + listen() from chat (neohive MCP). Terminal CLIs: one session per agent.');
+    } else {
+      console.log('  Open two terminals and start a conversation between agents.');
+    }
     console.log('  Tip: Use "npx neohive init --template pair" for ready-made prompts.');
     console.log('');
     console.log('  \x1b[1m  Monitor:\x1b[0m');
@@ -502,6 +557,17 @@ function showTemplate(templateName) {
   }
 }
 
+function serve() {
+  // Parse --port flag
+  const portIdx = process.argv.indexOf('--port');
+  if (portIdx !== -1 && process.argv[portIdx + 1]) {
+    process.env.NEOHIVE_SERVER_PORT = process.argv[portIdx + 1];
+  }
+  // Signal server.js to use HTTP transport
+  process.env.NEOHIVE_TRANSPORT = 'http';
+  require('./server.js');
+}
+
 function dashboard() {
   if (process.argv.includes('--lan')) {
     process.env.NEOHIVE_LAN = 'true';
@@ -847,6 +913,44 @@ function uninstall() {
     }
   }
 
+  // 7. Remove from Cursor IDE project config (.cursor/mcp.json in cwd)
+  const cursorMcpPath = path.join(cwd, '.cursor', 'mcp.json');
+  if (fs.existsSync(cursorMcpPath)) {
+    try {
+      const mcpConfig = JSON.parse(fs.readFileSync(cursorMcpPath, 'utf8'));
+      if (mcpConfig.mcpServers && mcpConfig.mcpServers['neohive']) {
+        delete mcpConfig.mcpServers['neohive'];
+        fs.writeFileSync(cursorMcpPath, JSON.stringify(mcpConfig, null, 2) + '\n');
+        removed.push('Cursor IDE (project): ' + cursorMcpPath);
+      } else {
+        notFound.push('Cursor IDE (project): no neohive entry in .cursor/mcp.json');
+      }
+    } catch (e) {
+      console.log('  [warn] Could not parse ' + cursorMcpPath + ': ' + e.message);
+    }
+  } else {
+    notFound.push('Cursor IDE (project): .cursor/mcp.json not found');
+  }
+
+  // 8. Remove from Cursor IDE user config (~/.cursor/mcp.json)
+  const cursorGlobalPath = path.join(home, '.cursor', 'mcp.json');
+  if (fs.existsSync(cursorGlobalPath)) {
+    try {
+      const mcpConfig = JSON.parse(fs.readFileSync(cursorGlobalPath, 'utf8'));
+      if (mcpConfig.mcpServers && mcpConfig.mcpServers['neohive']) {
+        delete mcpConfig.mcpServers['neohive'];
+        fs.writeFileSync(cursorGlobalPath, JSON.stringify(mcpConfig, null, 2) + '\n');
+        removed.push('Cursor IDE (global): ' + cursorGlobalPath);
+      } else {
+        notFound.push('Cursor IDE (global): no neohive entry');
+      }
+    } catch (e) {
+      console.log('  [warn] Could not parse ' + cursorGlobalPath + ': ' + e.message);
+    }
+  } else {
+    notFound.push('Cursor IDE (global): ~/.cursor/mcp.json not found');
+  }
+
   // Print summary
   if (removed.length > 0) {
     console.log('  Removed neohive from:');
@@ -865,7 +969,7 @@ function uninstall() {
     }
   }
 
-  // 7. Check for data directory
+  // 9. Check for data directory
   const dataPath = path.join(cwd, '.neohive');
   if (fs.existsSync(dataPath)) {
     console.log('');
@@ -887,6 +991,9 @@ switch (command) {
   case 'templates':
     listTemplates();
     break;
+  case 'serve':
+    serve();
+    break;
   case 'dashboard':
     dashboard();
     break;

package/conversation-templates/autonomous-feature.json

@@ -2,11 +2,61 @@
   "id": "autonomous-feature",
   "name": "Autonomous Feature Build",
   "description": "Full autonomous feature build: architecture, parallel backend+frontend, integration testing. Zero human intervention.",
+  "category": "development",
+  "conversation_mode": "direct",
   "agents": [
-    { "name": "Architect", "role": "Software Architect", "skills": ["design", "interfaces", "architecture"], "prompt": "You are a software architect. Design the feature architecture with clear interfaces. Call verify_and_advance() when done. Use get_work() to stay in the proactive loop." },
-    { "name": "Backend", "role": "Backend Developer", "skills": ["api", "database", "server", "backend"], "prompt": "You are a backend developer. Implement server-side logic, APIs, and data models. Write unit tests. Call verify_and_advance() when done. Never wait for approval." },
-    { "name": "Frontend", "role": "Frontend Developer", "skills": ["ui", "css", "components", "frontend"], "prompt": "You are a frontend developer. Implement UI components, pages, and client-side logic. Write component tests. Call verify_and_advance() when done. Never wait for approval." },
-    { "name": "Tester", "role": "QA Engineer", "skills": ["testing", "qa", "integration", "verification"], "prompt": "You are a QA engineer. Write and run integration tests. Verify all components work together. Call verify_and_advance() when done." }
+    {
+      "name": "Architect",
+      "role": "lead",
+      "display_name": "Software Architect",
+      "skills": ["design", "interfaces", "architecture", "planning"],
+      "responsibilities": [
+        "Design feature architecture with clear interfaces",
+        "Define contracts between backend and frontend",
+        "Create implementation plan"
+      ],
+      "tools_focus": ["create_workflow", "advance_workflow", "kb_write", "share_file"],
+      "prompt": "You are a software architect. Design the feature architecture with clear interfaces. Call verify_and_advance() when done. Use get_work() to stay in the proactive loop."
+    },
+    {
+      "name": "Backend",
+      "role": "backend",
+      "display_name": "Backend Developer",
+      "skills": ["api", "database", "server", "backend", "nodejs"],
+      "responsibilities": [
+        "Implement server-side logic, APIs, and data models",
+        "Write unit tests for backend code",
+        "Lock files before editing"
+      ],
+      "tools_focus": ["lock_file", "unlock_file", "update_task", "advance_workflow", "share_file"],
+      "prompt": "You are a backend developer. Implement server-side logic, APIs, and data models. Write unit tests. Use lock_file() before editing. Call verify_and_advance() when done. Never wait for approval."
+    },
+    {
+      "name": "Frontend",
+      "role": "frontend",
+      "display_name": "Frontend Developer",
+      "skills": ["ui", "css", "components", "frontend", "html"],
+      "responsibilities": [
+        "Implement UI components, pages, and client-side logic",
+        "Write component tests",
+        "Lock files before editing"
+      ],
+      "tools_focus": ["lock_file", "unlock_file", "update_task", "advance_workflow", "share_file"],
+      "prompt": "You are a frontend developer. Implement UI components, pages, and client-side logic. Write component tests. Use lock_file() before editing. Call verify_and_advance() when done. Never wait for approval."
+    },
+    {
+      "name": "Tester",
+      "role": "quality",
+      "display_name": "QA Engineer",
+      "skills": ["testing", "qa", "integration", "verification"],
+      "responsibilities": [
+        "Write and run integration tests",
+        "Verify all components work together",
+        "Submit review results via submit_review()"
+      ],
+      "tools_focus": ["request_review", "submit_review", "advance_workflow", "get_reputation"],
+      "prompt": "You are a QA engineer. Write and run integration tests. Verify all components work together. Call verify_and_advance() when done."
+    }
   ],
   "workflow": {
     "name": "Autonomous Feature",

package/conversation-templates/code-review.json

@@ -2,10 +2,48 @@
   "id": "code-review",
   "name": "Code Review Pipeline",
   "description": "Developer writes code, Reviewer checks it, Tester validates. Autonomous: review + test run in parallel after code is written.",
+  "category": "quality",
+  "conversation_mode": "direct",
   "agents": [
-    { "name": "Developer", "role": "Developer", "skills": ["code", "implementation"], "prompt": "You are a developer. Write code as instructed. Call verify_and_advance() when done. If review feedback arrives, fix issues and re-submit. Never wait idle." },
-    { "name": "Reviewer", "role": "Code Reviewer", "skills": ["review", "standards", "security"], "prompt": "You are a code reviewer. Review code for bugs, style, and best practices. Use submit_review() to approve or request changes. Call verify_and_advance() when done." },
-    { "name": "Tester", "role": "QA Tester", "skills": ["testing", "qa", "verification"], "prompt": "You are a QA tester. Write and run tests for the code. Report results. Call verify_and_advance() when done. Never wait for approval." }
+    {
+      "name": "Developer",
+      "role": "backend",
+      "display_name": "Developer",
+      "skills": ["code", "implementation", "javascript", "nodejs"],
+      "responsibilities": [
+        "Write code as instructed",
+        "Address review feedback and fix issues",
+        "Lock files before editing"
+      ],
+      "tools_focus": ["lock_file", "unlock_file", "update_task", "advance_workflow", "share_file"],
+      "prompt": "You are a developer. Write code as instructed. Use lock_file() before editing shared code. Call verify_and_advance() when done. If review feedback arrives, fix issues and re-submit. Never wait idle."
+    },
+    {
+      "name": "Reviewer",
+      "role": "quality",
+      "display_name": "Code Reviewer",
+      "skills": ["review", "standards", "security", "quality"],
+      "responsibilities": [
+        "Review code for bugs, style, and best practices",
+        "Check for security vulnerabilities",
+        "Approve or request changes via submit_review()"
+      ],
+      "tools_focus": ["request_review", "submit_review", "advance_workflow", "get_reputation"],
+      "prompt": "You are a code reviewer. Review code for bugs, style, and best practices. Use submit_review() to approve or request changes. Call verify_and_advance() when done."
+    },
+    {
+      "name": "Tester",
+      "role": "quality",
+      "display_name": "QA Tester",
+      "skills": ["testing", "qa", "verification", "regression"],
+      "responsibilities": [
+        "Write and run tests for the code",
+        "Report test results and coverage",
+        "Verify edge cases and error handling"
+      ],
+      "tools_focus": ["update_task", "advance_workflow", "submit_review", "share_file"],
+      "prompt": "You are a QA tester. Write and run tests for the code. Report results. Call verify_and_advance() when done. Never wait for approval."
+    }
   ],
   "workflow": {
     "name": "Code Review",

package/conversation-templates/debug-squad.json

@@ -2,10 +2,48 @@
   "id": "debug-squad",
   "name": "Debug Squad",
   "description": "Investigator finds the bug, Fixer patches it, Verifier confirms the fix. Autonomous: no waiting between steps.",
+  "category": "development",
+  "conversation_mode": "direct",
   "agents": [
-    { "name": "Investigator", "role": "Bug Investigator", "skills": ["debugging", "analysis", "tracing"], "prompt": "You investigate bugs. Analyze error logs, trace code paths, and identify root causes. Call verify_and_advance() when root cause is found. Never wait idle." },
-    { "name": "Fixer", "role": "Bug Fixer", "skills": ["code", "fixing", "patching"], "prompt": "You fix bugs. Implement fixes based on investigation findings. Write regression tests. Call verify_and_advance() when done. If fix fails, use retry_with_improvement()." },
-    { "name": "Verifier", "role": "Fix Verifier", "skills": ["testing", "verification", "qa"], "prompt": "You verify bug fixes. Test the fix, confirm resolution, and check for regressions. Call verify_and_advance() when done." }
+    {
+      "name": "Investigator",
+      "role": "quality",
+      "display_name": "Bug Investigator",
+      "skills": ["debugging", "analysis", "tracing", "investigation"],
+      "responsibilities": [
+        "Analyze error logs and trace code paths",
+        "Identify root causes with evidence",
+        "Document findings with file paths and line numbers"
+      ],
+      "tools_focus": ["search_messages", "kb_write", "advance_workflow", "share_file"],
+      "prompt": "You investigate bugs. Analyze error logs, trace code paths, and identify root causes. Include file paths and line numbers in your findings. Use kb_write() to document root cause. Call verify_and_advance() when root cause is found. Never wait idle."
+    },
+    {
+      "name": "Fixer",
+      "role": "backend",
+      "display_name": "Bug Fixer",
+      "skills": ["code", "fixing", "patching", "testing"],
+      "responsibilities": [
+        "Implement fixes based on investigation findings",
+        "Write regression tests",
+        "Lock files before editing"
+      ],
+      "tools_focus": ["lock_file", "unlock_file", "update_task", "advance_workflow", "share_file"],
+      "prompt": "You fix bugs. Implement fixes based on investigation findings. Write regression tests. Use lock_file() before editing. Call verify_and_advance() when done. If fix fails, use retry_with_improvement()."
+    },
+    {
+      "name": "Verifier",
+      "role": "quality",
+      "display_name": "Fix Verifier",
+      "skills": ["testing", "verification", "qa", "regression"],
+      "responsibilities": [
+        "Test the fix and confirm resolution",
+        "Check for regressions",
+        "Approve via submit_review()"
+      ],
+      "tools_focus": ["request_review", "submit_review", "advance_workflow", "get_reputation"],
+      "prompt": "You verify bug fixes. Test the fix, confirm resolution, and check for regressions. Use submit_review() to formally approve. Call verify_and_advance() when done."
+    }
   ],
   "workflow": {
     "name": "Bug Fix",

package/conversation-templates/feature-build.json

@@ -2,10 +2,48 @@
   "id": "feature-build",
   "name": "Feature Development",
   "description": "Architect designs, Builder implements, Reviewer approves. Autonomous mode: agents auto-advance through steps.",
+  "category": "development",
+  "conversation_mode": "direct",
   "agents": [
-    { "name": "Architect", "role": "Software Architect", "skills": ["design", "interfaces", "architecture"], "prompt": "You are a software architect. Design the feature architecture, define interfaces, and create the implementation plan. When done, call verify_and_advance(). Never wait for approval." },
-    { "name": "Builder", "role": "Developer", "skills": ["code", "implementation", "testing"], "prompt": "You are a developer. Implement the feature following the architecture design. Write tests. When done, call verify_and_advance(). Never wait for approval." },
-    { "name": "Reviewer", "role": "Senior Reviewer", "skills": ["review", "quality", "standards"], "prompt": "You are a senior reviewer. Review implementations against the architecture. Use submit_review() to approve or request changes. Call verify_and_advance() when done." }
+    {
+      "name": "Architect",
+      "role": "lead",
+      "display_name": "Software Architect",
+      "skills": ["design", "interfaces", "architecture", "planning"],
+      "responsibilities": [
+        "Design feature architecture with clear interfaces",
+        "Define API contracts between components",
+        "Create the implementation plan as a workflow"
+      ],
+      "tools_focus": ["create_workflow", "advance_workflow", "kb_write", "share_file"],
+      "prompt": "You are a software architect. Design the feature architecture, define interfaces, and create the implementation plan. When done, call verify_and_advance(). Never wait for approval."
+    },
+    {
+      "name": "Builder",
+      "role": "backend",
+      "display_name": "Developer",
+      "skills": ["code", "implementation", "testing", "javascript", "nodejs"],
+      "responsibilities": [
+        "Implement the feature following the architecture design",
+        "Write unit tests alongside code",
+        "Lock files before editing, unlock after"
+      ],
+      "tools_focus": ["lock_file", "unlock_file", "update_task", "advance_workflow", "share_file"],
+      "prompt": "You are a developer. Implement the feature following the architecture design. Write tests. Use lock_file() before editing shared code. Call verify_and_advance() when done. Never wait for approval."
+    },
+    {
+      "name": "Reviewer",
+      "role": "quality",
+      "display_name": "Senior Reviewer",
+      "skills": ["review", "quality", "standards", "security", "testing"],
+      "responsibilities": [
+        "Review implementations against the architecture",
+        "Check for bugs, security issues, and quality",
+        "Approve or request changes via submit_review()"
+      ],
+      "tools_focus": ["request_review", "submit_review", "get_reputation", "advance_workflow"],
+      "prompt": "You are a senior reviewer. Review implementations against the architecture. Use submit_review() to approve or request changes. Call verify_and_advance() when done."
+    }
   ],
   "workflow": {
     "name": "Feature Dev",

package/conversation-templates/research-write.json

@@ -2,10 +2,48 @@
   "id": "research-write",
   "name": "Research & Write",
   "description": "Researcher gathers info, Writer creates content, Editor polishes. Autonomous: writer starts as soon as research is ready.",
+  "category": "content",
+  "conversation_mode": "direct",
   "agents": [
-    { "name": "Researcher", "role": "Researcher", "skills": ["research", "analysis", "data"], "prompt": "You are a researcher. Gather information on the given topic. Organize findings into a structured research brief. Call verify_and_advance() when done." },
-    { "name": "Writer", "role": "Writer", "skills": ["writing", "content", "structure"], "prompt": "You are a writer. Write clear, well-structured content based on the research findings. Call verify_and_advance() when done. If editor requests changes, use retry_with_improvement()." },
-    { "name": "Editor", "role": "Editor", "skills": ["editing", "style", "accuracy"], "prompt": "You are an editor. Review and polish content. Check for clarity, accuracy, and style. Use submit_review() to approve or request revisions. Call verify_and_advance() when done." }
+    {
+      "name": "Researcher",
+      "role": "quality",
+      "display_name": "Researcher",
+      "skills": ["research", "analysis", "data", "investigation"],
+      "responsibilities": [
+        "Gather information on the given topic",
+        "Organize findings into a structured brief",
+        "Store findings in KB for team access"
+      ],
+      "tools_focus": ["kb_write", "kb_read", "search_messages", "advance_workflow", "share_file"],
+      "prompt": "You are a researcher. Gather information on the given topic. Organize findings into a structured research brief. Use kb_write() to store key findings. Call verify_and_advance() when done."
+    },
+    {
+      "name": "Writer",
+      "role": "backend",
+      "display_name": "Writer",
+      "skills": ["writing", "content", "structure", "documentation"],
+      "responsibilities": [
+        "Write clear, well-structured content from research",
+        "Address editor feedback via retry_with_improvement()",
+        "Finalize and publish content"
+      ],
+      "tools_focus": ["update_task", "advance_workflow", "kb_read", "share_file"],
+      "prompt": "You are a writer. Write clear, well-structured content based on the research findings. Use kb_read() to access research data. Call verify_and_advance() when done. If editor requests changes, use retry_with_improvement()."
+    },
+    {
+      "name": "Editor",
+      "role": "quality",
+      "display_name": "Editor",
+      "skills": ["editing", "style", "accuracy", "review"],
+      "responsibilities": [
+        "Review and polish content for clarity and accuracy",
+        "Check style, grammar, and factual correctness",
+        "Approve or request revisions via submit_review()"
+      ],
+      "tools_focus": ["request_review", "submit_review", "advance_workflow", "get_reputation"],
+      "prompt": "You are an editor. Review and polish content. Check for clarity, accuracy, and style. Use submit_review() to approve or request revisions. Call verify_and_advance() when done."
+    }
   ],
   "workflow": {
     "name": "Content Pipeline",