@local-labs-jpollock/local-addon-nexus-ai 0.3.2 → 0.4.0

package/README.md

@@ -52,8 +52,8 @@ Leverages Local's secure channels to WP Engine:
 
 ### Flexible AI Integration
 
-- **Bring Your Own Key (BYOK)** — Support for Anthropic, OpenAI, and Google LLM APIs
-- **Future-Ready** — Designed for WPE AI API Gateway integration
+- **Bring Your Own Key (BYOK)** — Anthropic (Claude), OpenAI (GPT), and Google (Gemini 2.5 Flash/Pro) — configure once, use across your fleet
+- **Local AI Gateway** — Centralized credential proxy so WordPress sites share your key without storing it per-site
 - **One-Click Setup** — Automated WordPress site configuration for AI use (keys, features, plugins)
 
 ### Developer Experience
@@ -66,6 +66,7 @@ Leverages Local's secure channels to WP Engine:
 
 - **CLI** — Terminal commands for all operations. Works with any AI that can write shell commands. No MCP setup required. Scriptable, automatable, transparent.
 - **MCP Server** — ~160 tools for AI assistants (Claude Desktop, Cursor, etc.)
+- **AI Chat (Discover tab)** — Built-in chat interface in Local UI. Ask questions about your fleet, get answers backed by real site data. Works with Anthropic, OpenAI, Google Gemini, Ollama, or the Local AI Gateway.
 - **WP Engine Remote Management** — Sync and manage WPE sites alongside local sites (see below)
 - **Database Health** — Scans WordPress databases for bloat (revisions, orphaned postmeta with plugin attribution, expired transients, autoload bloat, ghost plugin tables, auto-drafts, trash). Shows a 0–100 health score with advisor-voice recommendations and prevention tips. Safe cleanup via `nexus wp db clean` (dry-run default). Available via site card UI, CLI, and MCP tools. Local-only.
 - **Production-Ready Security** — Input validation, audit logging, credential redaction
@@ -73,6 +74,7 @@ Leverages Local's secure channels to WP Engine:
 - **AI Gateway** — Credential proxy, usage tracking, cost monitoring
 - **Event Tracking** — WordPress action/filter tracking with graph database
 - **Bulk Operations** — Fleet-wide operations with progress tracking and per-site results
+- **WP-CLI read/write permission split** — `wpcli_read` (plugin list, core version, user list) is **allowed on production by default**; write operations remain blocked. Configure per-environment in Preferences → WP Engine Access.
 - Semantic search across all site content with relevance scoring
 - WooCommerce product extraction (price, SKU, stock, attributes, categories)
 - ACF custom field enrichment (text, repeater, group, flexible content)
@@ -82,6 +84,8 @@ Leverages Local's secure channels to WP Engine:
 - 3-tier safety system with confirmation tokens for destructive operations
 - Per-platform packaging with native binary stripping
 
+**→ [What's New in v0.4.0](docs-site/docs/reference/whats-new-may-2026.md)**
+
 ## WP Engine Remote Management
 
 Nexus AI can sync your **WP Engine sites** into the same fleet view as your local sites, giving you unified search and management across your entire WordPress portfolio.
@@ -308,7 +312,7 @@ npm install                    # Install dependencies
 npm run download-model         # Download ONNX model (~30 MB)
 npm run build                  # Compile TypeScript + create entry points
 npm run watch                  # Watch mode for development
-npm test                       # Run unit tests (1,235 tests)
+npm test                       # Run unit tests (~2,200 tests)
 npm run test:eval              # Run eval tests (52, LLM evals need Ollama)
 npm run test:integration       # Run integration tests (187 tests)
 npm run test:e2e               # Run E2E tests (347 tests, requires Local running)
@@ -383,17 +387,20 @@ src/
 │           └── test-tools/          # 1 tool
 └── renderer/
     └── components/
-        ├── NexusOverview.tsx          # Fleet dashboard (7 active panels)
-        ├── NexusPreferences.tsx       # Addon settings
-        ├── SidebarSearchPanel.tsx     # Search integration
-        ├── SiteInfoWPE.tsx            # WPE site details
-        ├── AIGatewayUsagePanel.tsx    # AI usage tracking
+        ├── NexusOverview.tsx          # Main dashboard (Dashboard/Ask/Tell/Operations/Activity/Settings)
+        ├── SettingsTab.tsx            # Sync schedule, auto-index, WPE access controls
+        ├── SystemTab.tsx              # Site Status — per-site data level (Scanned/Configured/Searchable)
+        ├── ChatTab.tsx                # Ask/Tell AI assistant
+        ├── NexusPreferences.tsx       # AI provider, gateway, WPE credentials
+        ├── SidebarSearchPanel.tsx     # Site Finder search panel
+        ├── FleetCompletenessWidget.tsx # Data Completeness progress bars
         ├── BulkOperationsPanel.tsx    # Bulk operation progress
+        ├── AIGatewayPanel.tsx         # AI gateway usage tracking
         ├── EventTimeline.tsx          # Live event stream
         └── ...
 ```
 
-## MCP Tools (~111)
+## MCP Tools (~160)
 
 | Module | Tools | Description |
 |--------|-------|-------------|
@@ -417,7 +424,7 @@ Five-tier test pyramid. See [tests/TESTING-STRATEGY.md](tests/TESTING-STRATEGY.m
 
 | Tier | Command | What it tests |
 |------|---------|---------------|
-| Unit | `npm test` | Code logic with mocked deps (1,235 tests) |
+| Unit | `npm test` | Code logic with mocked deps (~2,200 tests) |
 | Eval | `npm run test:eval` | Content quality + LLM tool routing (52 tests) |
 | Integration | `npm run test:integration` | Real ONNX, LanceDB, MCP (187 tests) |
 | E2E | `npm run test:e2e` | Full addon in running Local (347 tests) |

package/lib/cli/commands/reset.d.ts

@@ -0,0 +1,25 @@
+/**
+ * nexus reset --factory
+ *
+ * Wipes all Nexus AI addon data as if the addon was just installed:
+ *   - IndexRegistry (content index state)
+ *   - SiteMetadataCache (WP versions, plugins, themes)
+ *   - Settings (AI provider, WPE permissions, scheduler config, etc.)
+ *   - API key status cache
+ *   - Site AI configs
+ *   - WPE install cache
+ *   - DB scan cache
+ *   - Graph DB (SQLite — plugins, themes, users, WPE sites, events)
+ *   - Vector store (LanceDB — all embeddings)
+ *
+ * What survives:
+ *   - API keys (stored in macOS Keychain, not in these files)
+ *   - WPE OAuth session (Local's own auth layer)
+ *   - Telemetry installationId (nexus-ai/config.json)
+ *
+ * Local MUST be stopped before running this — electron-store flushes
+ * to disk on exit and would overwrite the deleted files.
+ */
+import { Command } from 'commander';
+export declare const resetCommand: Command;
+//# sourceMappingURL=reset.d.ts.map

package/lib/cli/commands/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/reset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6DpC,eAAO,MAAM,YAAY,SAuErB,CAAC"}

package/lib/cli/commands/reset.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * nexus reset --factory
+ *
+ * Wipes all Nexus AI addon data as if the addon was just installed:
+ *   - IndexRegistry (content index state)
+ *   - SiteMetadataCache (WP versions, plugins, themes)
+ *   - Settings (AI provider, WPE permissions, scheduler config, etc.)
+ *   - API key status cache
+ *   - Site AI configs
+ *   - WPE install cache
+ *   - DB scan cache
+ *   - Graph DB (SQLite — plugins, themes, users, WPE sites, events)
+ *   - Vector store (LanceDB — all embeddings)
+ *
+ * What survives:
+ *   - API keys (stored in macOS Keychain, not in these files)
+ *   - WPE OAuth session (Local's own auth layer)
+ *   - Telemetry installationId (nexus-ai/config.json)
+ *
+ * Local MUST be stopped before running this — electron-store flushes
+ * to disk on exit and would overwrite the deleted files.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetCommand = void 0;
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const paths_1 = require("../bootstrap/paths");
+const ADDON_PREFIX = 'nexus-ai';
+function getDataFiles(dataDir) {
+    return [
+        { label: 'Index registry (content index state)', path: path.join(dataDir, `${ADDON_PREFIX}_index_registry.json`) },
+        { label: 'Site metadata cache (WP version, plugins)', path: path.join(dataDir, `${ADDON_PREFIX}_site_metadata.json`) },
+        { label: 'Settings (provider, permissions, etc.)', path: path.join(dataDir, `${ADDON_PREFIX}_settings.json`) },
+        { label: 'API key status cache', path: path.join(dataDir, `${ADDON_PREFIX}_api_key_status.json`) },
+        { label: 'Site AI configurations', path: path.join(dataDir, `${ADDON_PREFIX}_site_ai_config.json`) },
+        { label: 'WPE install cache', path: path.join(dataDir, `${ADDON_PREFIX}_wpe_install_cache.json`) },
+        { label: 'DB scan cache', path: path.join(dataDir, `${ADDON_PREFIX}_db_scan_cache.json`) },
+        { label: 'Graph DB (plugins, themes, users, events)', path: path.join(dataDir, ADDON_PREFIX, 'graph.db') },
+        { label: 'Graph DB WAL files', path: path.join(dataDir, ADDON_PREFIX, 'graph.db-shm') },
+        { label: 'Graph DB WAL files', path: path.join(dataDir, ADDON_PREFIX, 'graph.db-wal') },
+        { label: 'Vector store / embeddings (LanceDB)', path: path.join(dataDir, ADDON_PREFIX, 'vectors'), isDir: true },
+    ];
+}
+function isLocalRunning(dataDir) {
+    try {
+        const infoFile = path.join(dataDir, 'graphql-connection-info.json');
+        if (!fs.existsSync(infoFile))
+            return false;
+        // If the GraphQL info file exists and was modified recently, Local may be running
+        const stat = fs.statSync(infoFile);
+        const ageMs = Date.now() - stat.mtimeMs;
+        return ageMs < 60 * 60 * 1000; // modified in last hour = likely running
+    }
+    catch {
+        return false;
+    }
+}
+function deleteItem(entry) {
+    try {
+        if (!fs.existsSync(entry.path))
+            return 'not-found';
+        if (entry.isDir) {
+            fs.rmSync(entry.path, { recursive: true, force: true });
+        }
+        else {
+            fs.unlinkSync(entry.path);
+        }
+        return 'deleted';
+    }
+    catch {
+        return 'error';
+    }
+}
+async function promptConfirm() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question('Type "reset" to confirm: ', (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'reset');
+        });
+    });
+}
+exports.resetCommand = new commander_1.Command('reset')
+    .description('Factory reset — wipe all Nexus AI data as if the addon was just installed')
+    .option('--factory', 'Required flag — confirms this is a full data wipe')
+    .option('--confirm', 'Skip interactive confirmation prompt')
+    .option('--dry-run', 'Show what would be deleted without deleting anything')
+    .action(async (options) => {
+    if (!options.factory) {
+        console.error('Error: --factory flag required. This command wipes all Nexus AI data.');
+        console.error('Usage: nexus reset --factory');
+        process.exit(1);
+    }
+    const { dataDir } = (0, paths_1.getLocalPaths)();
+    const entries = getDataFiles(dataDir);
+    const existing = entries.filter(e => fs.existsSync(e.path));
+    if (existing.length === 0) {
+        console.log('\n✓ Already clean — no Nexus AI data found.\n');
+        return;
+    }
+    // Warning header
+    console.log('\n⚠  NEXUS AI FACTORY RESET\n');
+    console.log('This will permanently delete:\n');
+    existing.forEach(e => console.log(`  • ${e.label}`));
+    console.log('\nWhat is NOT deleted:');
+    console.log('  • API keys (stored in macOS Keychain)');
+    console.log('  • WPE OAuth session');
+    console.log('  • Telemetry ID\n');
+    // Local running check
+    if (isLocalRunning(dataDir)) {
+        console.log('⚠  Local appears to be running. Stop Local before resetting,');
+        console.log('   otherwise electron-store will recreate the deleted files on exit.\n');
+    }
+    if (options.dryRun) {
+        console.log('DRY RUN — nothing deleted. Remove --dry-run to execute.\n');
+        return;
+    }
+    // Confirmation
+    if (!options.confirm) {
+        const confirmed = await promptConfirm();
+        if (!confirmed) {
+            console.log('\nCancelled.\n');
+            process.exit(0);
+        }
+    }
+    // Execute
+    console.log('\nDeleting...\n');
+    let deleted = 0;
+    let errors = 0;
+    for (const entry of entries) {
+        const result = deleteItem(entry);
+        if (result === 'deleted') {
+            console.log(`  ✓ ${entry.label}`);
+            deleted++;
+        }
+        else if (result === 'error') {
+            console.log(`  ✗ ${entry.label} (error)`);
+            errors++;
+        }
+        // not-found = skip silently
+    }
+    console.log(`\n${deleted} items deleted${errors > 0 ? `, ${errors} errors` : ''}.`);
+    console.log('\nRestart Local — Nexus AI will initialize from scratch.\n');
+    if (errors > 0)
+        process.exit(1);
+});
+//# sourceMappingURL=reset.js.map

package/lib/cli/commands/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../../src/cli/commands/reset.ts"],"names":[],"mappings":"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"}

package/lib/cli/commands/system.d.ts

@@ -0,0 +1,11 @@
+/**
+ * nexus system status
+ *
+ * Programmatic inspection of all four data stores for all local sites.
+ * Returns machine-readable JSON or a human-readable table.
+ *
+ * Used by e2e tests to verify state after operations without opening the UI.
+ */
+import { Command } from 'commander';
+export declare const systemCommand: Command;
+//# sourceMappingURL=system.d.ts.map

package/lib/cli/commands/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6DpC,eAAO,MAAM,aAAa,SACuC,CAAC"}

package/lib/cli/commands/system.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemCommand = void 0;
+/**
+ * nexus system status
+ *
+ * Programmatic inspection of all four data stores for all local sites.
+ * Returns machine-readable JSON or a human-readable table.
+ *
+ * Used by e2e tests to verify state after operations without opening the UI.
+ */
+const commander_1 = require("commander");
+const graphql_1 = require("../utils/graphql");
+async function getSystemStatus(ipcInvoke) {
+    const [sites, indexEntries] = await Promise.all([
+        ipcInvoke('nexus-ai:get-sites'),
+        ipcInvoke('nexus-ai:get-fleet-status'),
+    ]);
+    const localSites = Array.isArray(sites)
+        ? sites.filter((s) => s.source !== 'wpe')
+        : (sites?.local ?? []);
+    const indexMap = new Map();
+    if (Array.isArray(indexEntries)) {
+        indexEntries.forEach((e) => indexMap.set(e.siteId, e));
+    }
+    // Fetch metadata for each site in parallel
+    const metaResults = await Promise.all(localSites.map(async (site) => {
+        try {
+            const res = await ipcInvoke('nexus-ai:metadata:get', site.id);
+            return { siteId: site.id, metadata: res?.metadata?.metadata ?? null, ageString: res?.ageString ?? null };
+        }
+        catch {
+            return { siteId: site.id, metadata: null, ageString: null };
+        }
+    }));
+    const metaMap = new Map();
+    metaResults.forEach(r => metaMap.set(r.siteId, r));
+    return localSites.map((site) => {
+        const entry = indexMap.get(site.id);
+        const metaRes = metaMap.get(site.id);
+        const meta = metaRes?.metadata;
+        return {
+            siteId: site.id,
+            siteName: site.name,
+            siteStatus: site.status,
+            // Content Index (IndexRegistry)
+            indexState: entry?.state ?? 'idle',
+            documentCount: entry?.documentCount ?? 0,
+            chunkCount: entry?.chunkCount ?? 0,
+            lastIndexed: entry?.lastIndexed ?? null,
+            indexErrors: entry?.errors ?? [],
+            // Metadata Cache (SiteMetadataCache)
+            metaCached: !!meta,
+            wpVersion: meta?.wpVersion ?? null,
+            phpVersion: meta?.phpVersion ?? null,
+            pluginCount: meta?.plugins?.length ?? null,
+            postCount: meta?.postCount ?? null,
+            metaUpdatedAt: meta?.lastUpdated ?? null,
+            metaSource: meta?.updateSource ?? null,
+            metaAge: metaRes?.ageString ?? null,
+        };
+    });
+}
+exports.systemCommand = new commander_1.Command('system')
+    .description('Inspect data store state across all local sites');
+exports.systemCommand
+    .command('status')
+    .description('Show content index + metadata cache state for all local sites')
+    .option('--json', 'Output as JSON (machine-readable)')
+    .option('--site <name>', 'Filter to a specific site by name')
+    .action(async (options) => {
+    try {
+        // Use GraphQL client to reach the addon (same as all other CLI commands)
+        const client = (0, graphql_1.getClient)();
+        // We need IPC access — use a GraphQL mutation that proxies to IPC
+        // For now, use nexusSitesList which gives us sites + index state
+        const listResult = await client.mutate(`
+        mutation {
+          nexusSitesList {
+            local {
+              id
+              name
+              status
+              phpVersion
+              wpVersion
+              indexState
+              documentCount
+              chunkCount
+              lastIndexed
+              pluginCount
+              postCount
+              metaUpdatedAt
+              metaAge
+              metaSource
+            }
+          }
+        }
+      `, {});
+        let sites = listResult.nexusSitesList?.local ?? [];
+        if (options.site) {
+            sites = sites.filter((s) => s.name === options.site || s.id === options.site);
+        }
+        // local[] is already local-only
+        if (options.json) {
+            console.log(JSON.stringify(sites, null, 2));
+            return;
+        }
+        // Human-readable table
+        const col = (s, w) => s.slice(0, w).padEnd(w);
+        console.log('\nNexus AI — System Status\n');
+        console.log(col('Site', 20) +
+            col('Status', 9) +
+            col('Index', 10) +
+            col('Docs', 7) +
+            col('WP', 10) +
+            col('PHP', 8) +
+            col('Plugins', 8) +
+            'Meta age');
+        console.log('─'.repeat(82));
+        sites.forEach((s) => {
+            const indexMark = s.indexState === 'indexed' ? '✓' : s.indexState === 'indexing' ? '…' : s.indexState === 'error' ? '✗' : '—';
+            const metaMark = s.wpVersion ? `${s.wpVersion ?? '?'}` : '—';
+            console.log(col(s.name, 20) +
+                col(s.status ?? '?', 9) +
+                col(`${indexMark} ${s.indexState ?? 'idle'}`, 10) +
+                col(s.documentCount ? String(s.documentCount) : '—', 7) +
+                col(metaMark, 10) +
+                col(s.phpVersion ?? '—', 8) +
+                col(s.pluginCount != null ? String(s.pluginCount) : '—', 8) +
+                (s.metaAge ?? '—'));
+        });
+        console.log('');
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=system.js.map

package/lib/cli/commands/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../src/cli/commands/system.ts"],"names":[],"mappings":"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"}

package/lib/cli/commands/wp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wp.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/wp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,QAAA,MAAM,SAAS,SAAgE,CAAC;AA8/BhF,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"wp.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/wp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,QAAA,MAAM,SAAS,SAAgE,CAAC;AAoiChF,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/lib/cli/commands/wp.js

@@ -924,6 +924,52 @@ wpCommand
         process.exit(1);
     }
 });
+// ============================================================================
+// Users (graph DB) Command
+// ============================================================================
+wpCommand
+    .command('users <target>')
+    .description('List WordPress users for a site (from graph DB — site must have been indexed)')
+    .option('--json', 'Output as JSON')
+    .action(async (target, options) => {
+    try {
+        const client = (0, graphql_1.getClient)();
+        // Extract siteId from target — for local sites target is "sitename@local"
+        const siteId = target.includes('@') ? target.split('@')[0] : target;
+        const result = await client.mutate(`
+        mutation($siteId: String!) {
+          nexusSiteUsers(siteId: $siteId) {
+            success
+            error
+            siteId
+            users { userId username email roles }
+          }
+        }
+      `, { siteId });
+        const { success, error, users } = result.nexusSiteUsers;
+        if (!success) {
+            console.error(`Error: ${error}`);
+            process.exit(1);
+        }
+        if (options.json) {
+            console.log(JSON.stringify(users, null, 2));
+            return;
+        }
+        if (users.length === 0) {
+            console.log('No users found (site may not be indexed yet)');
+            return;
+        }
+        console.log(`\nUsers on ${target}:\n`);
+        users.forEach((u) => {
+            const roleStr = u.roles.join(', ');
+            console.log(`  ${u.username} <${u.email}> [${roleStr}]`);
+        });
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
 // Add subcommands
 wpCommand.addCommand(pluginCommand);
 wpCommand.addCommand(themeCommand);