@local-labs-jpollock/local-addon-nexus-ai 0.3.1 → 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":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,yCAAoC;AACpC,uCAAyB;AACzB,2CAA6B;AAC7B,mDAAqC;AACrC,8CAAmD;AAEnD,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO;QACL,EAAE,KAAK,EAAE,sCAAsC,EAAI,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,sBAAsB,CAAC,EAAE;QACpH,EAAE,KAAK,EAAE,2CAA2C,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,qBAAqB,CAAC,EAAE;QACtH,EAAE,KAAK,EAAE,wCAAwC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,gBAAgB,CAAC,EAAE;QAC9G,EAAE,KAAK,EAAE,sBAAsB,EAAoB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,sBAAsB,CAAC,EAAE;QACpH,EAAE,KAAK,EAAE,wBAAwB,EAAkB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,sBAAsB,CAAC,EAAE;QACpH,EAAE,KAAK,EAAE,mBAAmB,EAAuB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,yBAAyB,CAAC,EAAE;QACvH,EAAE,KAAK,EAAE,eAAe,EAA2B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,qBAAqB,CAAC,EAAE;QACnH,EAAE,KAAK,EAAE,2CAA2C,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE;QAC1G,EAAE,KAAK,EAAE,oBAAoB,EAAsB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE;QAC3G,EAAE,KAAK,EAAE,oBAAoB,EAAsB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE;QAC3G,EAAE,KAAK,EAAE,qCAAqC,EAAK,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;KACpH,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;QACpE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,kFAAkF;QAClF,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACxC,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,yCAAyC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAwC;IAC1D,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,WAAW,CAAC;QACnD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,2BAA2B,EAAE,CAAC,MAAM,EAAE,EAAE;YAClD,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAEY,QAAA,YAAY,GAAG,IAAI,mBAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,2EAA2E,CAAC;KACxF,MAAM,CAAC,WAAW,EAAE,mDAAmD,CAAC;KACxE,MAAM,CAAC,WAAW,EAAE,sCAAsC,CAAC;KAC3D,MAAM,CAAC,WAAW,EAAE,sDAAsD,CAAC;KAC3E,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;QACvF,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,qBAAa,GAAE,CAAC;IACpC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IAED,iBAAiB;IACjB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAElC,sBAAsB;IACtB,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IAED,eAAe;IACf,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;QACxC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,UAAU;IACV,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;aAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,KAAK,UAAU,CAAC,CAAC;YAC1C,MAAM,EAAE,CAAC;QACX,CAAC;QACD,4BAA4B;IAC9B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,iBAAiB,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpF,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAE1E,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * nexus settings — Read and update Nexus AI settings
+ *
+ * Commands:
+ *   nexus settings get [key]        Read all settings or a specific dotted-path key
+ *   nexus settings set <key> <val>  Set a single dotted-path key to a value
+ *   nexus settings patch <json>     Merge a JSON object into current settings
+ */
+import { Command } from 'commander';
+declare const settingsCommand: Command;
+export { settingsCommand };
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,QAAA,MAAM,eAAe,SAA2E,CAAC;AAmMjG,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/lib/cli/commands/settings.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * nexus settings — Read and update Nexus AI settings
+ *
+ * Commands:
+ *   nexus settings get [key]        Read all settings or a specific dotted-path key
+ *   nexus settings set <key> <val>  Set a single dotted-path key to a value
+ *   nexus settings patch <json>     Merge a JSON object into current settings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingsCommand = void 0;
+const commander_1 = require("commander");
+const graphql_1 = require("../utils/graphql");
+const settingsCommand = new commander_1.Command('settings').description('Read and update Nexus AI settings');
+exports.settingsCommand = settingsCommand;
+// ---------------------------------------------------------------------------
+// nexus settings get [key]
+// ---------------------------------------------------------------------------
+settingsCommand
+    .command('get [key]')
+    .description('Read settings. Pass a dotted path to read a specific field (e.g. wpeOperationPermissions.wpcli.production).')
+    .option('--json', 'Output raw JSON')
+    .action(async (key, options) => {
+    try {
+        const client = (0, graphql_1.getClient)();
+        const result = await client.mutate(`
+        mutation($key: String) {
+          nexusGetSettings(key: $key) {
+            success
+            error
+            settings
+          }
+        }
+      `, { key: key ?? null });
+        const { success, error, settings } = result.nexusGetSettings;
+        if (!success || !settings) {
+            console.error(`Error: ${error ?? 'No settings returned'}`);
+            process.exit(1);
+        }
+        const parsed = JSON.parse(settings);
+        if (options.json || key) {
+            console.log(JSON.stringify(parsed, null, 2));
+        }
+        else {
+            // Pretty table for full settings dump
+            console.log('\nNexus AI Settings\n' + '─'.repeat(40));
+            printSettings(parsed, '');
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+function printSettings(obj, prefix) {
+    for (const [k, v] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${k}` : k;
+        if (v !== null && typeof v === 'object' && !Array.isArray(v)) {
+            printSettings(v, fullKey);
+        }
+        else {
+            console.log(`  ${fullKey.padEnd(48)} ${JSON.stringify(v)}`);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// nexus settings set <key> <value>
+// ---------------------------------------------------------------------------
+settingsCommand
+    .command('set <key> <value>')
+    .description([
+    'Set a single setting by dotted path.',
+    '',
+    'Examples:',
+    '  nexus settings set wpeOperationPermissions.wpcli.production true',
+    '  nexus settings set wpeOperationPermissions.push.production false',
+    '  nexus settings set autoIndex true',
+    '  nexus settings set wpeSyncIntervalHours 4',
+].join('\n'))
+    .action(async (key, value) => {
+    try {
+        const client = (0, graphql_1.getClient)();
+        const result = await client.mutate(`
+        mutation($key: String, $value: String) {
+          nexusUpdateSettings(key: $key, value: $value) {
+            success
+            error
+            settings
+          }
+        }
+      `, { key, value });
+        const { success, error, settings } = result.nexusUpdateSettings;
+        if (!success) {
+            console.error(`Error: ${error ?? 'Update failed'}`);
+            process.exit(1);
+        }
+        const parsed = JSON.parse(settings);
+        // Show just the updated field
+        const current = key.split('.').reduce((acc, k) => acc?.[k], parsed);
+        console.log(`✓ ${key} = ${JSON.stringify(current)}`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+// ---------------------------------------------------------------------------
+// nexus settings patch <json>
+// ---------------------------------------------------------------------------
+settingsCommand
+    .command('patch <json>')
+    .description([
+    'Merge a JSON object into current settings.',
+    '',
+    'Examples:',
+    '  nexus settings patch \'{"wpeOperationPermissions":{"wpcli":{"production":true}}}\'',
+    '  nexus settings patch \'{"autoIndex":false,"wpeSyncIntervalHours":12}\'',
+].join('\n'))
+    .action(async (jsonStr) => {
+    try {
+        // Validate JSON before sending
+        JSON.parse(jsonStr);
+        const client = (0, graphql_1.getClient)();
+        const result = await client.mutate(`
+        mutation($patch: String) {
+          nexusUpdateSettings(patch: $patch) {
+            success
+            error
+            settings
+          }
+        }
+      `, { patch: jsonStr });
+        const { success, error } = result.nexusUpdateSettings;
+        if (!success) {
+            console.error(`Error: ${error ?? 'Patch failed'}`);
+            process.exit(1);
+        }
+        console.log('✓ Settings updated');
+    }
+    catch (err) {
+        if (err.message?.includes('JSON')) {
+            console.error(`Invalid JSON: ${err.message}`);
+        }
+        else {
+            console.error(`Error: ${err.message}`);
+        }
+        process.exit(1);
+    }
+});
+// ---------------------------------------------------------------------------
+// nexus settings reset
+// ---------------------------------------------------------------------------
+settingsCommand
+    .command('reset')
+    .description('Clear all Nexus AI settings and revert to defaults. Requires confirmation.')
+    .option('--confirm', 'Confirm that you want to reset all settings')
+    .action(async (options) => {
+    if (!options.confirm) {
+        console.error('Add --confirm to reset all Nexus AI settings to defaults.');
+        process.exit(1);
+    }
+    try {
+        const client = (0, graphql_1.getClient)();
+        const result = await client.mutate(`
+        mutation {
+          nexusUpdateSettings(patch: "{}") {
+            success
+            error
+          }
+        }
+      `, {});
+        // Patch with empty object doesn't reset; we need to set to empty
+        const resetResult = await client.mutate(`
+        mutation($patch: String) {
+          nexusUpdateSettings(patch: $patch) {
+            success
+            error
+          }
+        }
+      `, { patch: JSON.stringify({ autoIndex: true, excludedSiteIds: [], wpeOperationPermissions: null, wpeSiteExceptions: null }) });
+        if (!resetResult.nexusUpdateSettings.success) {
+            console.error(`Error: ${resetResult.nexusUpdateSettings.error ?? 'Reset failed'}`);
+            process.exit(1);
+        }
+        console.log('✓ Settings reset to defaults');
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=settings.js.map

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

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