monomind 1.10.17 → 1.10.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monomind",
-  "version": "1.10.17",
+  "version": "1.10.19",
   "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.17",
+  "version": "1.10.19",
   "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/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 "$@"

package/scripts/ua-enrich.mjs

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+/**
+ * ua-enrich.mjs — Option C
+ *
+ * Background enrichment runner that:
+ *  1. Runs the Understand-Anything extract-structure.mjs deterministic extraction
+ *     on changed (or all) files in a project directory.
+ *  2. Merges the resulting structural + metadata into an existing monograph DB
+ *     WITHOUT requiring the full LLM agent pipeline.
+ *
+ * For full LLM semantic enrichment (summaries, layers), run the /understand
+ * skill separately and then call ua-import.mjs on the resulting graph.json.
+ *
+ * This script is designed to be called from the post-edit or post-build hook
+ * as a lightweight, non-LLM enrichment step that runs in <2s.
+ *
+ * Usage:
+ *   node scripts/ua-enrich.mjs [--dir <projectDir>] [--file <changedFile>] [--db <monograph.db>]
+ *
+ * Options:
+ *   --dir   Project root to scan (default: cwd)
+ *   --file  Single file to re-enrich (incremental mode)
+ *   --db    Path to monograph.db (default: <dir>/.monomind/monograph.db)
+ *   --full  Force full scan even if graph.json exists
+ *
+ * Env:
+ *   UA_GRAPH_JSON  Override path to UA graph.json
+ *   UA_PLUGIN_DIR  Override path to understand-anything-plugin directory
+ */
+
+import { readFileSync, existsSync, statSync, writeFileSync, mkdirSync } from 'fs';
+import { resolve, join, dirname, basename } from 'path';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import { execSync, spawnSync } from 'child_process';
+
+const __dir = dirname(fileURLToPath(import.meta.url));
+const CWD   = process.cwd();
+
+// ── Parse CLI args ───────────────────────────────────────────────────────────
+function arg(name) {
+  const i = process.argv.indexOf('--' + name);
+  return i !== -1 ? process.argv[i + 1] : null;
+}
+const hasFlag = (f) => process.argv.includes('--' + f);
+
+const projectDir  = resolve(arg('dir') || CWD);
+const changedFile = arg('file') ? resolve(arg('file')) : null;
+const dbPath      = resolve(arg('db') || join(projectDir, '.monomind', 'monograph.db'));
+const fullScan    = hasFlag('full');
+
+// ── Locate Understand-Anything plugin ───────────────────────────────────────
+function findUAPlugin() {
+  const envPath = process.env.UA_PLUGIN_DIR;
+  if (envPath && existsSync(envPath)) return resolve(envPath);
+
+  // Common sibling locations relative to the monomind root
+  const candidates = [
+    join(__dir, '..', '..', 'knowledgegraph', 'Understand-Anything', 'understand-anything-plugin'),
+    join(dirname(__dir), '..', 'knowledgegraph', 'Understand-Anything', 'understand-anything-plugin'),
+  ];
+  for (const c of candidates) {
+    if (existsSync(c)) return c;
+  }
+  return null;
+}
+
+// ── Locate extract-structure.mjs ─────────────────────────────────────────────
+function findExtractScript(pluginDir) {
+  const candidates = [
+    join(pluginDir, 'skills', 'understand', 'extract-structure.mjs'),
+    join(pluginDir, 'extract-structure.mjs'),
+  ];
+  for (const c of candidates) {
+    if (existsSync(c)) return c;
+  }
+  return null;
+}
+
+// ── Resolve monograph package ────────────────────────────────────────────────
+function requireMonograph() {
+  const require = createRequire(import.meta.url);
+  const candidates = [
+    join(CWD, 'node_modules/.pnpm/node_modules/@monoes/monograph'),
+    join(CWD, 'packages/node_modules/.pnpm/node_modules/@monoes/monograph'),
+    join(CWD, 'node_modules/@monoes/monograph'),
+  ];
+  for (const c of candidates) {
+    try { if (existsSync(c)) return require(c); } catch {}
+  }
+  try { return require('@monoes/monograph'); } catch {}
+  throw new Error('Cannot find @monoes/monograph');
+}
+
+// ── Check for existing UA graph.json ────────────────────────────────────────
+function findUAGraph(dir) {
+  if (process.env.UA_GRAPH_JSON) return process.env.UA_GRAPH_JSON;
+  const candidates = [
+    join(dir, '.understand', 'knowledge-graph.json'),
+    join(dir, '.understand', 'graph.json'),
+    join(dir, '.ua', 'knowledge-graph.json'),
+    join(dir, '.ua', 'graph.json'),
+    join(dir, 'graph.json'),
+  ];
+  for (const c of candidates) {
+    if (existsSync(c)) return c;
+  }
+  return null;
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+  console.log('[UA-ENRICH] Starting enrichment for', projectDir);
+
+  if (!existsSync(dbPath)) {
+    console.log('[UA-ENRICH] monograph.db not found — skipping (build monograph first)');
+    process.exit(0);
+  }
+
+  const mg = requireMonograph();
+  const db = mg.openDb(dbPath);
+
+  // ── Phase 1: Try importing existing UA graph.json ──────────────────────────
+  const existingGraph = findUAGraph(projectDir);
+  if (existingGraph && !fullScan) {
+    const stat = statSync(existingGraph);
+    const ageHours = (Date.now() - stat.mtimeMs) / 3_600_000;
+    if (ageHours < 24) {
+      console.log(`[UA-ENRICH] Found recent graph.json (${ageHours.toFixed(1)}h old) — importing`);
+      mg.closeDb(db);
+      // Delegate to ua-import.mjs
+      const importScript = join(__dir, 'ua-import.mjs');
+      if (existsSync(importScript)) {
+        const result = spawnSync(process.execPath, [importScript, existingGraph, dbPath], {
+          stdio: 'inherit', cwd: CWD,
+        });
+        process.exit(result.status ?? 0);
+      }
+      console.log('[UA-ENRICH] ua-import.mjs not found — continuing with direct enrichment');
+    } else {
+      console.log(`[UA-ENRICH] graph.json is ${ageHours.toFixed(0)}h old — will re-enrich from DB only`);
+    }
+  }
+
+  // ── Phase 2: Deterministic structural extraction (no LLM) ─────────────────
+  // Run UA's extract-structure.mjs on the target file/directory and capture output.
+  const pluginDir = findUAPlugin();
+  const extractScript = pluginDir ? findExtractScript(pluginDir) : null;
+
+  if (extractScript && changedFile) {
+    console.log('[UA-ENRICH] Running deterministic extraction on', basename(changedFile));
+    try {
+      const result = spawnSync(process.execPath, [extractScript, changedFile], {
+        cwd: projectDir,
+        timeout: 10_000,
+        encoding: 'utf-8',
+      });
+      if (result.stdout) {
+        let extracted;
+        try { extracted = JSON.parse(result.stdout); } catch { extracted = null; }
+        if (extracted && extracted.functions) {
+          // Write extracted structural data back into the node's properties
+          const normPath = changedFile.startsWith(projectDir)
+            ? changedFile.slice(projectDir.length + 1)
+            : changedFile;
+          const row = db.prepare("SELECT id, properties FROM nodes WHERE file_path LIKE ? LIMIT 1")
+            .get('%' + basename(changedFile));
+          if (row) {
+            const existing = row.properties ? JSON.parse(row.properties) : {};
+            const merged = {
+              ...existing,
+              ua_extracted: {
+                functions:  extracted.functions?.length ?? 0,
+                classes:    extracted.classes?.length ?? 0,
+                imports:    extracted.imports?.length ?? 0,
+                exports:    extracted.exports?.length ?? 0,
+                updatedAt:  new Date().toISOString(),
+              },
+            };
+            db.prepare("UPDATE nodes SET properties = ? WHERE id = ?")
+              .run(JSON.stringify(merged), row.id);
+            console.log(`[UA-ENRICH] Updated structural data for ${row.id}`);
+          }
+        }
+      }
+    } catch (e) {
+      console.log('[UA-ENRICH] Extraction warning:', e.message);
+    }
+  } else if (!extractScript) {
+    console.log('[UA-ENRICH] UA extract script not found — skipping deterministic extraction');
+    console.log('[UA-ENRICH] Set UA_PLUGIN_DIR env var or place Understand-Anything beside monomind');
+  }
+
+  // ── Phase 3: Propagate existing UA summaries to FTS ───────────────────────
+  // If nodes have ua_type/summary in properties but FTS is stale, rebuild it.
+  try {
+    const enrichedCount = db.prepare(
+      `SELECT COUNT(*) AS c FROM nodes WHERE properties LIKE '%ua_type%'`
+    ).get().c;
+    if (enrichedCount > 0) {
+      console.log(`[UA-ENRICH] ${enrichedCount} UA-enriched nodes in DB`);
+      db.prepare(`INSERT INTO nodes_fts(nodes_fts) VALUES('rebuild')`).run();
+      console.log('[UA-ENRICH] FTS rebuilt');
+    } else {
+      console.log('[UA-ENRICH] No UA enrichment data yet — run ua-import.mjs after /understand');
+    }
+  } catch { /* FTS may not exist */ }
+
+  // ── Phase 4: Write enrichment status to .monomind/ ────────────────────────
+  try {
+    const statusPath = join(projectDir, '.monomind', 'ua-enrich-status.json');
+    writeFileSync(statusPath, JSON.stringify({
+      lastRun: new Date().toISOString(),
+      mode: changedFile ? 'incremental' : 'full',
+      file: changedFile || null,
+      pluginFound: !!pluginDir,
+      graphFound: !!existingGraph,
+    }, null, 2));
+  } catch {}
+
+  mg.closeDb(db);
+  console.log('[UA-ENRICH] Done');
+}
+
+main().catch((e) => {
+  console.error('[UA-ENRICH] Error:', e.message);
+  process.exit(1);
+});