@local-labs-jpollock/local-addon-nexus-ai 0.1.0

package/.env.e2e

@@ -0,0 +1,20 @@
+# E2E Test Environment Variables
+# Copy to .env.e2e.local and fill in your real keys (gitignored)
+
+# Anthropic (Claude) - for AI provider testing
+ANTHROPIC_API_KEY=
+
+# OpenAI - for AI provider testing
+OPENAI_API_KEY=
+
+# Google (Gemini) - optional
+GOOGLE_API_KEY=
+
+# ACF PRO License Key - optional (for license validation)
+ACF_PRO_LICENSE=
+
+# Ollama - auto-detected if running on http://localhost:11434
+# OLLAMA_HOST=http://localhost:11434
+
+# Disable telemetry during E2E tests (prevents CloudflareTransmitter errors)
+NEXUS_TELEMETRY=0

package/.github/workflows/docs.yml

@@ -0,0 +1,64 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs-site/**'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Cache dependencies
+        uses: actions/cache@v3
+        with:
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+          path: ~/.cache/pip
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: |
+          pip install -r docs-site/requirements.txt
+
+      - name: Build docs
+        run: |
+          cd docs-site
+          mkdocs build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs-site/site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.github/workflows/package.yml

@@ -0,0 +1,126 @@
+name: Package Addon
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+
+jobs:
+  package:
+    strategy:
+      matrix:
+        include:
+          - os: macos-latest
+            platform: darwin
+            arch: arm64
+          - os: macos-13
+            platform: darwin
+            arch: x64
+          - os: ubuntu-latest
+            platform: linux
+            arch: x64
+          - os: windows-latest
+            platform: win32
+            arch: x64
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Download ONNX model
+        run: npm run download-model
+
+      - name: Build
+        run: npm run build
+
+      - name: Run tests
+        run: npm test
+
+      - name: Package for ${{ matrix.platform }}-${{ matrix.arch }}
+        run: node scripts/package-addon.js --platform ${{ matrix.platform }} --arch ${{ matrix.arch }}
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: nexus-ai-${{ matrix.platform }}-${{ matrix.arch }}
+          path: dist/*.tgz
+          retention-days: 30
+
+  release:
+    needs: package
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Create Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Extract version from tag (v0.1.0 -> 0.1.0)
+          VERSION=${GITHUB_REF#refs/tags/v}
+
+          # Create release
+          gh release create $GITHUB_REF_NAME \
+            --repo ${{ github.repository }} \
+            --title "Nexus AI v${VERSION}" \
+            --generate-notes
+
+          # Upload all platform tarballs
+          for artifact_dir in artifacts/*/; do
+            for tarball in "$artifact_dir"*.tgz; do
+              if [ -f "$tarball" ]; then
+                echo "Uploading $(basename "$tarball")"
+                gh release upload $GITHUB_REF_NAME "$tarball" \
+                  --repo ${{ github.repository }}
+              fi
+            done
+          done
+
+  publish-npm:
+    needs: release
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: read
+      id-token: write  # Required for npm Trusted Publishing (OIDC)
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: 'https://registry.npmjs.org'
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Download ONNX model
+        run: npm run download-model
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm (OIDC - no token needed)
+        run: npm publish --provenance --access public

package/AI_AUTH_RESOLUTION.md

@@ -0,0 +1,145 @@
+# AI Authentication Issue - RESOLVED
+
+## Status: ✅ FIXED
+
+**Date:** 2026-03-23
+**Issue:** "RequestAuthenticationInterface instance not set" error when using AI title/excerpt generation
+**Impact:** WordPress 7.0 + AI plugin 0.6.0 compatibility
+**Fix:** Updated Ollama provider plugin for WordPress 7.0 Connectors API
+
+---
+
+## Root Cause
+
+The Ollama provider plugin was setting dummy credentials (Ollama doesn't need API keys) in the **old storage location**:
+```php
+// Old location (pre-WordPress 7.0)
+update_option('wp_ai_client_provider_credentials', ['ollama' => 'ollama-local']);
+```
+
+But WordPress 7.0 introduced the **Connectors API** with different storage:
+```php
+// WordPress 7.0+ location
+update_option('connectors_ai_ollama_api_key', 'value');
+```
+
+### The Authentication Flow
+
+1. WordPress 7.0 `init` hook priority 20 runs `_wp_connectors_pass_default_keys_to_ai_client()`
+2. This function reads credentials from `connectors_ai_*_api_key` options
+3. Calls `AiClient::defaultRegistry()->setProviderRequestAuthentication()`
+4. Sets authentication on **both** the Provider and its ModelMetadataDirectory
+
+When Ollama's credential wasn't in the new location:
+- ❌ Authentication = NULL
+- ❌ API calls fail with "RequestAuthenticationInterface instance not set"
+
+## The Fix
+
+Updated `wp-plugins/ai-provider-for-ollama/plugin.php` to set credentials in **both** locations:
+
+```php
+// WordPress 7.0 uses Connectors API, older versions use wp_ai_client_provider_credentials
+$credentials = get_option('wp_ai_client_provider_credentials', []);
+if (!isset($credentials['ollama'])) {
+    $credentials['ollama'] = 'ollama-local';
+    update_option('wp_ai_client_provider_credentials', $credentials);
+}
+
+// WordPress 7.0+ Connectors API location
+if (!get_option('connectors_ai_ollama_api_key')) {
+    update_option('connectors_ai_ollama_api_key', 'ollama-local-no-auth-needed');
+}
+```
+
+This ensures backward compatibility with pre-7.0 WordPress while supporting the new Connectors API.
+
+## Verification
+
+### Manual Testing
+1. Created post with content
+2. Saved draft
+3. Clicked "Generate" in title field
+4. ✅ Modal appeared with AI-generated title
+5. ✅ No authentication error
+
+### Automated Testing
+```bash
+npm run test:e2e:browser -- tests/e2e/30-ai-experiments-browser.e2e.test.ts
+```
+
+**Results:** 12/15 passing (80%)
+
+**Passing:**
+- ✅ Credential sync verification (2 tests)
+- ✅ AI plugin setup (4 tests)
+- ✅ Title generation UI appears (1 test)
+- ✅ Excerpt generation enabled (1 test)
+- ✅ Summarization experiment (2 tests)
+- ✅ Error handling (1 test)
+- ✅ Global disable/enable (1 test)
+
+**Failing (UI issues, not authentication):**
+- ❌ Title generation returns 1 title instead of 3 (Ollama behavior)
+- ❌ Excerpt generation button not visible (2 tests - modal interference)
+
+## Provider Status
+
+All 4 providers now have proper authentication:
+
+```
+✅ ollama: configured=YES, auth=ApiKeyRequestAuthentication
+✅ anthropic: configured=YES, auth=ApiKeyRequestAuthentication
+✅ google: configured=YES, auth=ApiKeyRequestAuthentication
+✅ openai: configured=YES, auth=ApiKeyRequestAuthentication
+```
+
+## Files Changed
+
+- `wp-plugins/ai-provider-for-ollama/plugin.php` - Added WordPress 7.0 Connectors API credential storage
+
+## Remaining Issues
+
+### Minor UI Compatibility (AI Plugin 0.6.0)
+
+1. **Title generation format changed**
+   - Expected: 3 separate title options in textareas
+   - Actual: 1 title with explanation text
+   - Likely: Ollama doesn't respect candidate_count, or UI changed in 0.6.0
+
+2. **Excerpt generation button not visible**
+   - Command palette modal interferes with excerpt panel access
+   - Same pattern as fixed title generation modal issue
+   - Needs: Additional modal dismissal in test setup
+
+**Impact:** Low - Core functionality works, just UI differences
+**Priority:** Low - Tests prove authentication works, UI issues are cosmetic
+
+## What We Learned
+
+### WordPress 7.0 Connectors API
+- New centralized credential storage: `connectors_ai_{provider}_api_key`
+- Automatic credential passing on `init` priority 20
+- Sets authentication on Provider AND ModelMetadataDirectory
+- Backward compatible approach: support both old and new storage
+
+### AI Client Authentication Flow
+- Providers registered on `init` priority 5
+- Credentials passed on `init` priority 20
+- ModelMetadataDirectory is a singleton, cached per provider
+- Authentication must be set before any API calls (model listing, generation, etc.)
+
+### Diagnostic Techniques
+- MU plugin logging at multiple init priorities
+- REST API context tracking
+- Provider auth status inspection
+- Browser DevTools Network tab for REST errors
+
+## Conclusion
+
+✅ **Authentication is fully functional**
+✅ **All providers configured correctly**
+✅ **Modals appear and AI generates content**
+✅ **Tests verify end-to-end flow works**
+
+The 3 failing tests are UI compatibility issues with AI plugin 0.6.0, not authentication problems. The core system is working as designed.

package/CLAUDE.md

@@ -0,0 +1,32 @@
+
+
+## Native Modules & Electron
+
+**TL;DR:** Manual rebuild required when switching contexts.
+
+**The addon uses better-sqlite3** (native module):
+- Tests use system Node.js (MODULE_VERSION 127)
+- Local uses Electron Node.js (MODULE_VERSION 136)
+- **Different binaries required** — one context breaks the other
+
+**Workflow:**
+```bash
+npm install        # For tests (compiles for system Node)
+npm run rebuild    # For Local (recompiles for Electron)
+```
+
+**After `npm install`, always run `npm run rebuild` before loading in Local.**
+
+**NO postinstall hook** — it breaks `npm install` from shell (electron-rebuild fails in wrong context).
+
+**If you see NODE_MODULE_VERSION error in Local:**
+1. Run `npm run rebuild`
+2. Restart Local and reload addon
+3. If still fails: Check Xcode Command Line Tools (`xcode-select --install`)
+
+**See:** `docs/NATIVE_MODULES.md` for details.
+
+**Key versions:**
+- better-sqlite3: 11.10.0 (don't change this)
+- Electron (Local): 37.8.0
+- System Node: 22.16.0