monomind 1.10.18 → 1.10.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monomind",
-  "version": "1.10.18",
+  "version": "1.10.20",
   "description": "Monomind - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
   "main": "dist/index.js",
   "type": "module",
@@ -27,6 +27,8 @@
     "packages/@monomind/cli/scripts/**/*.js",
     "packages/@monomind/cli/scripts/**/*.sh",
     "packages/@monomind/cli/package.json",
+    "scripts/*.mjs",
+    "scripts/*.sh",
     "packages/@monomind/shared/dist/**/*.js",
     "packages/@monomind/shared/dist/**/*.d.ts",
     "!packages/@monomind/shared/dist/**/*.map",

package/packages/@monomind/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/monomindcli",
-  "version": "1.10.18",
+  "version": "1.10.20",
   "type": "module",
   "description": "Monomind CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",

package/packages/@monomind/cli/scripts/understand-analyze.mjs

@@ -30,7 +30,7 @@ import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
 import { resolve, join, dirname, basename, relative } from 'node:path';
 import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
-import { execFileSync } from 'node:child_process';
+import { execFileSync, execSync, spawn } from 'node:child_process';
 
 const __dir = dirname(fileURLToPath(import.meta.url));
 const CWD   = process.cwd();
@@ -128,12 +128,60 @@ function detectLayersHeuristic(fileNodes) {
   return layers;
 }
 
-// ── Anthropic API helpers (raw fetch — no SDK needed) ────────────────────────
+// ── Anthropic API helpers ─────────────────────────────────────────────────────
+// Two paths:
+//   1. Direct API via ANTHROPIC_API_KEY (fastest, parallel-safe, requires key)
+//   2. `claude -p` CLI passthrough (reuses Claude Code's auth — no key needed)
+//      Slower (CLI cold-start per call), but works inside any Claude Code
+//      session without extra setup.
 const ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY;
 const ANTHROPIC_URL     = 'https://api.anthropic.com/v1/messages';
 const MODEL             = 'claude-haiku-4-5-20251001'; // cheapest for bulk analysis
 
-async function callClaude(systemPrompt, userPrompt, maxTokens = 1024) {
+// Detect `claude` CLI once at startup.
+let _claudeCliPath = null;
+function _detectClaudeCli() {
+  if (_claudeCliPath !== null) return _claudeCliPath;
+  try {
+    const out = execSync('command -v claude 2>/dev/null', { encoding: 'utf-8' }).trim();
+    _claudeCliPath = out || '';
+  } catch { _claudeCliPath = ''; }
+  return _claudeCliPath;
+}
+
+const USE_CLAUDE_CLI = !ANTHROPIC_API_KEY && !!_detectClaudeCli();
+
+async function callClaudeViaCli(systemPrompt, userPrompt, maxTokens = 1024) {
+  return new Promise((resolveP, reject) => {
+    const args = [
+      '-p',
+      '--model', 'haiku',
+      '--output-format', 'text',
+      '--bare', // skip hooks/skills/auto-memory — we want a fast, clean call
+      // Combine system + user into a single prompt argument
+      `${systemPrompt}\n\n---\n\n${userPrompt}`,
+    ];
+    const child = spawn(_claudeCliPath, args, {
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: { ...process.env },
+    });
+    let out = '', err = '';
+    child.stdout.on('data', d => out += d.toString());
+    child.stderr.on('data', d => err += d.toString());
+    const timeout = setTimeout(() => {
+      child.kill('SIGKILL');
+      reject(new Error('claude -p timed out after 60s'));
+    }, 60000);
+    child.on('close', code => {
+      clearTimeout(timeout);
+      if (code !== 0) return reject(new Error(`claude -p exited ${code}: ${err.slice(0, 200)}`));
+      resolveP(out.trim());
+    });
+    child.on('error', e => { clearTimeout(timeout); reject(e); });
+  });
+}
+
+async function callClaudeViaApi(systemPrompt, userPrompt, maxTokens = 1024) {
   const body = JSON.stringify({
     model: MODEL,
     max_tokens: maxTokens,
@@ -153,7 +201,6 @@ async function callClaude(systemPrompt, userPrompt, maxTokens = 1024) {
         const data = await resp.json();
         return data.content?.[0]?.text ?? '';
       }
-      // Retry on 429 (rate limit) and 5xx; fail fast on 4xx
       if (resp.status === 429 || resp.status >= 500) {
         const retryAfter = parseInt(resp.headers.get('retry-after') || '0', 10);
         const backoff = retryAfter > 0 ? retryAfter * 1000 : Math.min(2 ** attempt * 1000, 8000);
@@ -172,6 +219,16 @@ async function callClaude(systemPrompt, userPrompt, maxTokens = 1024) {
   throw lastError || new Error('Anthropic API failed after 3 attempts');
 }
 
+async function callClaude(systemPrompt, userPrompt, maxTokens = 1024) {
+  if (ANTHROPIC_API_KEY) {
+    return callClaudeViaApi(systemPrompt, userPrompt, maxTokens);
+  }
+  if (USE_CLAUDE_CLI) {
+    return callClaudeViaCli(systemPrompt, userPrompt, maxTokens);
+  }
+  throw new Error('No LLM path available: set ANTHROPIC_API_KEY or install `claude` CLI');
+}
+
 function parseJson(text) {
   try {
     const fenceMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
@@ -640,12 +697,13 @@ async function main() {
   const batch = toAnalyze.slice(0, limit);
   console.log(`[understand] Analyzing ${batch.length} files (${toAnalyze.length - batch.length} skipped/already enriched)`);
 
-  if (!ANTHROPIC_API_KEY && !noLlm) {
-    console.warn('[understand] ANTHROPIC_API_KEY not set — falling back to --no-llm heuristic mode');
-    // Fall through to heuristic only
+  const llmPath = ANTHROPIC_API_KEY ? 'api' : (USE_CLAUDE_CLI ? 'claude-cli' : 'none');
+  if (llmPath === 'none' && !noLlm) {
+    console.warn('[understand] No LLM path available (no ANTHROPIC_API_KEY and no `claude` CLI) — falling back to --no-llm heuristic mode');
+  } else if (llmPath === 'claude-cli' && !noLlm) {
+    console.log('[understand] Using `claude -p` CLI passthrough (no API key needed; reusing Claude Code auth)');
   }
-
-  const useLlm = !noLlm && !!ANTHROPIC_API_KEY;
+  const useLlm = !noLlm && llmPath !== 'none';
 
   // ── Get project context for better prompts ────────────────────────────────
   let projectContext = `Project directory: ${basename(projectDir)}`;
@@ -798,7 +856,7 @@ async function main() {
 async function detectAndWriteLayers(db, fileNodes, forceHeuristic, dryRun, dir) {
   let layers;
 
-  if (!forceHeuristic && ANTHROPIC_API_KEY) {
+  if (!forceHeuristic && (ANTHROPIC_API_KEY || USE_CLAUDE_CLI)) {
     console.log('[understand] Detecting architectural layers via LLM...');
     const filePaths = fileNodes.map(n => n.file_path).filter(Boolean);
     try {

package/scripts/install.sh

@@ -0,0 +1,392 @@
+#!/usr/bin/env bash
+#
+# Monomind Installer (formerly Monomind)
+# https://github.com/nokhodian/monomind
+#
+# Usage:
+#   curl -fsSL https://cdn.jsdelivr.net/gh/nokhodian/monomind@main/scripts/install.sh | bash
+#   curl -fsSL https://cdn.jsdelivr.net/gh/nokhodian/monomind@main/scripts/install.sh | bash -s -- --full
+#   curl -fsSL https://cdn.jsdelivr.net/gh/nokhodian/monomind@main/scripts/install.sh | bash -s -- --global
+#   curl -fsSL https://cdn.jsdelivr.net/gh/nokhodian/monomind@main/scripts/install.sh | bash -s -- --minimal
+#
+# Options (via arguments):
+#   --global              Global install (npm install -g)
+#   --minimal             Minimal install (no optional deps)
+#   --full                Full setup (global + MCP + doctor + init)
+#   --version=X.X.X       Specific version
+#
+# Options (via environment - requires export):
+#   export MONOMIND_VERSION=alpha
+#   export MONOMIND_MINIMAL=1
+#   export MONOMIND_GLOBAL=1
+#
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+DIM='\033[2m'
+NC='\033[0m' # No Color
+
+# Default configuration (can be overridden by env vars)
+VERSION="${MONOMIND_VERSION:-${MONOMIND_VERSION:-latest}}"
+MINIMAL="${MONOMIND_MINIMAL:-0}"
+GLOBAL="${MONOMIND_GLOBAL:-0}"
+SETUP_MCP="${MONOMIND_SETUP_MCP:-0}"
+RUN_DOCTOR="${MONOMIND_DOCTOR:-0}"
+RUN_INIT="${MONOMIND_INIT:-1}"
+
+# Parse command line arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --global|-g)
+            GLOBAL="1"
+            shift
+            ;;
+        --minimal|-m)
+            MINIMAL="1"
+            shift
+            ;;
+        --setup-mcp|--mcp)
+            SETUP_MCP="1"
+            shift
+            ;;
+        --doctor|-d)
+            RUN_DOCTOR="1"
+            shift
+            ;;
+        --init|-i)
+            RUN_INIT="1"
+            shift
+            ;;
+        --no-init)
+            RUN_INIT="0"
+            shift
+            ;;
+        --full|-f)
+            GLOBAL="1"
+            SETUP_MCP="1"
+            RUN_DOCTOR="1"
+            RUN_INIT="1"
+            shift
+            ;;
+        --version=*)
+            VERSION="${1#*=}"
+            shift
+            ;;
+        --help|-h)
+            echo "Monomind Installer"
+            echo ""
+            echo "Usage: curl -fsSL .../install.sh | bash -s -- [OPTIONS]"
+            echo ""
+            echo "Options:"
+            echo "  --global, -g     Install globally (npm install -g monomind)"
+            echo "  --minimal, -m    Minimal install (skip optional deps)"
+            echo "  --setup-mcp      Auto-configure MCP server for Claude Code"
+            echo "  --doctor, -d     Run diagnostics after install"
+            echo "  --no-init        Skip project initialization (enabled by default)"
+            echo "  --full, -f       Full setup (global + mcp + doctor + init)"
+            echo "  --version=X.X.X  Install specific version (default: alpha)"
+            echo "  --help, -h       Show this help"
+            exit 0
+            ;;
+        *)
+            shift
+            ;;
+    esac
+done
+
+PACKAGE="monomind@${VERSION}"
+
+# Progress animation
+SPINNER_CHARS="⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+SPINNER_INDEX=0
+
+spinner() {
+    printf "\r${CYAN}${SPINNER_CHARS:SPINNER_INDEX++:1}${NC} $1"
+    SPINNER_INDEX=$((SPINNER_INDEX % 10))
+}
+
+print_banner() {
+    echo ""
+    echo -e "${CYAN}╔═══════════════════════════════════════════════════════════╗${NC}"
+    echo -e "${CYAN}║${NC}  ${BOLD}Monomind${NC} — AI Agent Orchestration for Claude Code     ${CYAN}║${NC}"
+    echo -e "${CYAN}╚═══════════════════════════════════════════════════════════╝${NC}"
+    echo ""
+}
+
+print_step() {
+    echo -e "${GREEN}▸${NC} $1"
+}
+
+print_substep() {
+    echo -e "  ${DIM}├─${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+print_info() {
+    echo -e "${BLUE}ℹ${NC} $1"
+}
+
+check_requirements() {
+    print_step "Checking requirements..."
+
+    # Check Node.js
+    if command -v node &> /dev/null; then
+        NODE_VERSION=$(node -v | sed 's/v//')
+        NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d. -f1)
+        if [ "$NODE_MAJOR" -ge 20 ]; then
+            print_substep "Node.js ${GREEN}v${NODE_VERSION}${NC} ✓"
+        else
+            print_error "Node.js 20+ required (found v${NODE_VERSION})"
+            echo ""
+            echo "Install Node.js 20+:"
+            echo "  curl -fsSL https://fnm.vercel.app/install | bash"
+            echo "  fnm install 20"
+            exit 1
+        fi
+    else
+        print_error "Node.js not found"
+        echo ""
+        echo "Install Node.js 20+:"
+        echo "  curl -fsSL https://fnm.vercel.app/install | bash"
+        echo "  fnm install 20"
+        exit 1
+    fi
+
+    # Check npm
+    if command -v npm &> /dev/null; then
+        NPM_VERSION=$(npm -v)
+        print_substep "npm ${GREEN}v${NPM_VERSION}${NC} ✓"
+    else
+        print_error "npm not found"
+        exit 1
+    fi
+
+    # Check Claude Code CLI
+    if command -v claude &> /dev/null; then
+        CLAUDE_VERSION=$(claude --version 2>/dev/null | head -1 || echo "installed")
+        print_substep "Claude Code ${GREEN}${CLAUDE_VERSION}${NC} ✓"
+    else
+        print_warning "Claude Code CLI not found"
+        print_substep "Installing Claude Code CLI via npm..."
+        if npm install -g @anthropic-ai/claude-code 2>/dev/null; then
+            if command -v claude &> /dev/null; then
+                CLAUDE_VERSION=$(claude --version 2>/dev/null | head -1 || echo "installed")
+                print_substep "Claude Code ${GREEN}${CLAUDE_VERSION}${NC} ✓"
+            else
+                print_substep "Installed. Restart terminal to use 'claude' command"
+            fi
+        else
+            print_warning "npm install failed. Try manually:"
+            print_substep "${BOLD}npm install -g @anthropic-ai/claude-code${NC}"
+        fi
+    fi
+
+    echo ""
+}
+
+show_install_options() {
+    print_step "Installation options:"
+    print_substep "Package: ${BOLD}${PACKAGE}${NC}"
+    if [ "$GLOBAL" = "1" ]; then
+        print_substep "Mode: ${BOLD}Global${NC} (npm install -g)"
+    else
+        print_substep "Mode: ${BOLD}npx${NC} (on-demand)"
+    fi
+    if [ "$MINIMAL" = "1" ]; then
+        print_substep "Profile: ${BOLD}Minimal${NC} (--omit=optional)"
+    else
+        print_substep "Profile: ${BOLD}Full${NC} (all features)"
+    fi
+    echo ""
+}
+
+install_package() {
+    local START_TIME=$(date +%s)
+
+    if [ "$GLOBAL" = "1" ]; then
+        print_step "Installing globally..."
+
+        if [ "$MINIMAL" = "1" ]; then
+            npm install -g "$PACKAGE" --omit=optional 2>&1 | while read -r line; do
+                if [[ "$line" == *"added"* ]]; then
+                    print_substep "$line"
+                fi
+            done
+        else
+            npm install -g "$PACKAGE" 2>&1 | while read -r line; do
+                if [[ "$line" == *"added"* ]]; then
+                    print_substep "$line"
+                fi
+            done
+        fi
+    else
+        print_step "Installing for npx usage..."
+        # Actually run npx to pre-install the package
+        npx -y "$PACKAGE" --version >/dev/null 2>&1 || true
+        print_substep "Package installed for npx"
+    fi
+
+    local END_TIME=$(date +%s)
+    local DURATION=$((END_TIME - START_TIME))
+
+    echo ""
+    print_success "Installed in ${BOLD}${DURATION}s${NC}"
+}
+
+verify_installation() {
+    print_step "Verifying installation..."
+
+    local VERSION_OUTPUT
+    if [ "$GLOBAL" = "1" ]; then
+        VERSION_OUTPUT=$(monomind --version 2>/dev/null || monomind --version 2>/dev/null || echo "")
+        if [ -z "$VERSION_OUTPUT" ]; then
+            print_warning "Global command not found in PATH"
+            print_substep "Try: ${BOLD}npm install -g monomind@${VERSION}${NC}"
+            return 0  # Don't fail - npm might need PATH refresh
+        fi
+    else
+        # For npx mode, package was already installed during install_package
+        VERSION_OUTPUT=$(npx "$PACKAGE" --version 2>/dev/null || echo "")
+    fi
+
+    if [ -n "$VERSION_OUTPUT" ]; then
+        print_substep "Version: ${GREEN}${VERSION_OUTPUT}${NC}"
+        echo ""
+        return 0
+    else
+        print_error "Installation verification failed"
+        return 1
+    fi
+}
+
+show_quickstart() {
+    echo -e "${CYAN}╔═══════════════════════════════════════════════════════════╗${NC}"
+    echo -e "${CYAN}║${NC}  ${BOLD}Quick Start${NC}                                              ${CYAN}║${NC}"
+    echo -e "${CYAN}╚═══════════════════════════════════════════════════════════╝${NC}"
+    echo ""
+
+    if [ "$GLOBAL" = "1" ]; then
+        echo -e "  ${DIM}# Initialize project${NC}"
+        echo -e "  ${BOLD}monomind init --wizard${NC}"
+        echo ""
+        echo -e "  ${DIM}# Run system diagnostics${NC}"
+        echo -e "  ${BOLD}monomind doctor${NC}"
+        echo ""
+        echo -e "  ${DIM}# Add as MCP server to Claude Code${NC}"
+        echo -e "  ${BOLD}claude mcp add monomind -- monomind mcp start${NC}"
+    else
+        echo -e "  ${DIM}# Initialize project${NC}"
+        echo -e "  ${BOLD}npx monomind@latest init --wizard${NC}"
+        echo ""
+        echo -e "  ${DIM}# Run system diagnostics${NC}"
+        echo -e "  ${BOLD}npx monomind@latest doctor${NC}"
+        echo ""
+        echo -e "  ${DIM}# Add as MCP server to Claude Code${NC}"
+        echo -e "  ${BOLD}claude mcp add monomind -- npx -y monomind@latest mcp start${NC}"
+    fi
+
+    echo ""
+    echo -e "${DIM}Documentation: https://github.com/nokhodian/monomind${NC}"
+    echo -e "${DIM}Issues: https://github.com/nokhodian/monomind/issues${NC}"
+    echo ""
+}
+
+setup_mcp_server() {
+    if [ "$SETUP_MCP" != "1" ]; then
+        return 0
+    fi
+
+    print_step "Setting up MCP server..."
+
+    if ! command -v claude &> /dev/null; then
+        print_warning "Claude CLI not found, skipping MCP setup"
+        return 0
+    fi
+
+    # Check if already configured
+    if claude mcp list 2>/dev/null | grep -q "monomind\|monomind"; then
+        print_substep "MCP server already configured ✓"
+        return 0
+    fi
+
+    # Add MCP server (pass MONOMIND_CWD so tools resolve paths correctly
+    # even when the MCP server is spawned with cwd='/')
+    if [ "$GLOBAL" = "1" ]; then
+        claude mcp add monomind -e MONOMIND_CWD="$HOME" -- monomind mcp start 2>/dev/null && \
+            print_substep "MCP server configured ✓" || \
+            print_warning "MCP setup failed - run manually: claude mcp add monomind -e MONOMIND_CWD=\"\$HOME\" -- monomind mcp start"
+    else
+        claude mcp add monomind -e MONOMIND_CWD="$HOME" -- npx -y monomind@${VERSION} mcp start 2>/dev/null && \
+            print_substep "MCP server configured ✓" || \
+            print_warning "MCP setup failed - run manually: claude mcp add monomind -e MONOMIND_CWD=\"\$HOME\" -- npx -y monomind@latest mcp start"
+    fi
+    echo ""
+}
+
+run_doctor() {
+    if [ "$RUN_DOCTOR" != "1" ]; then
+        return 0
+    fi
+
+    print_step "Running diagnostics..."
+    echo ""
+
+    if [ "$GLOBAL" = "1" ]; then
+        monomind doctor 2>&1 || true
+    else
+        npx monomind@${VERSION} doctor 2>&1 || true
+    fi
+    echo ""
+}
+
+run_init() {
+    if [ "$RUN_INIT" != "1" ]; then
+        return 0
+    fi
+
+    print_step "Initializing project..."
+    echo ""
+
+    if [ "$GLOBAL" = "1" ]; then
+        monomind init --yes 2>&1 || true
+    else
+        npx monomind@${VERSION} init --yes 2>&1 || true
+    fi
+    echo ""
+}
+
+# Main
+main() {
+    print_banner
+    check_requirements
+    show_install_options
+    install_package
+    verify_installation
+    setup_mcp_server
+    run_doctor
+    run_init
+    show_quickstart
+
+    print_success "${BOLD}Monomind is ready!${NC}"
+    echo ""
+}
+
+main "$@"